home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / dsz0920.zip / DSZ.DOC < prev    next >
Text File  |  1994-09-20  |  161KB  |  4,603 lines

  1.  
  2.  
  3.  
  4.  
  5.                                      CONTENTS
  6.  
  7.  
  8.       1.  ZMODEM Features at a Glance....................................   1
  9.  
  10.       2.  TUTORIAL INTRODUCTION..........................................   3
  11.  
  12.       3.  CALLING DSZ FROM COMM PROGRAMS.................................   4
  13.           3.1    USE AN INTERFACE PROGRAM?...............................   4
  14.           3.2    MSKermit 3.xx...........................................   4
  15.           3.3    PROCOMM PLUS............................................   5
  16.           3.4    Qmodem..................................................   6
  17.           3.5    TELIX...................................................   8
  18.  
  19.       4.  BULLETIN BOARD CONSIDERATIONS..................................  10
  20.  
  21.       5.  DESCRIPTION....................................................  11
  22.  
  23.       6.  COMMANDS.......................................................  13
  24.           6.1    List of Commands........................................  13
  25.           6.2    Interrupt Keys..........................................  19
  26.  
  27.       7.  NUMERIC PARAMETERS.............................................  20
  28.  
  29.       8.  ENVIRONMENT VARIABLES..........................................  24
  30.  
  31.       9.  EXIT STATUS....................................................  28
  32.  
  33.      10.  EXAMPLES.......................................................  29
  34.  
  35.      11.  BACKGROUND OPERATION...........................................  30
  36.           11.1   Microsoft Windows.......................................  31
  37.           11.2   VM......................................................  32
  38.  
  39.      12.  TERMINAL SERVERS...............................................  33
  40.                  12.0.1  PORT WATCHERS  34
  41.  
  42.      13.  FLOW CONTROL...................................................  35
  43.  
  44.      14.  ERROR MESSAGES.................................................  36
  45.           14.1   Got ZRPOS...............................................  37
  46.           14.2   Subpacket too Long......................................  38
  47.           14.3   Bad CRC.................................................  38
  48.           14.4   Garbled Data Subpacket..................................  38
  49.           14.5   Serial Input Error: Line Status Register xx ............  39
  50.           14.6   TIMEOUT.................................................  42
  51.           14.7   No Carrier Detect.......................................  42
  52.           14.8   Port %d (%X) defective..................................  42
  53.           14.9   COMMAND NOT FOUND.......................................  42
  54.           14.10  Out of Environment......................................  42
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      15.  SLOW TRANSFERS.................................................  44
  65.  
  66.      16.  IN CASE OF DIFFICULTY..........................................  45
  67.           16.1   LOCKUPS.................................................  45
  68.                  16.1.1  Insufficient Memory  45
  69.                  16.1.2  Environment TOO BIG  45
  70.                  16.1.3  Bad COM Port Configuration  45
  71.                  16.1.4  LAN Manager Conflicts  46
  72.           16.2   Incorrect Batch Files...................................  47
  73.           16.3   Cheap Internal Modems...................................  47
  74.           16.4   Commands Entered in Upper Case..........................  47
  75.           16.5   No Carrier Detect.......................................  47
  76.           16.6   DOS 3.x.................................................  48
  77.           16.7   Perstor Controllers.....................................  48
  78.           16.8   IBM PS/2 Model 50Z......................................  48
  79.           16.9   Brain Damaged UARTS.....................................  48
  80.                  16.9.1  Everex Internal Modems  50
  81.           16.10  Weird Iron..............................................  51
  82.           16.11  PKARC 3.6...............................................  51
  83.           16.12  Will the real YMODEM please stand up?...................  51
  84.           16.13  286 and 386 Extended Memory.............................  51
  85.           16.14  Disk Caches.............................................  52
  86.  
  87.      17.  ASSOCIATED DOCUMENTS...........................................  53
  88.  
  89.      18.  FILES..........................................................  54
  90.  
  91.      19.  Other Omen Technology Products.................................  56
  92.           19.1   Professional-YAM COMMS TOOLS............................  56
  93.           19.2   ZCOMM: Industrial Strength COMMS Shareware..............  56
  94.           19.3   ZMODEM Developer's Collection...........................  56
  95.  
  96.      20.  FAIR PLAY......................................................  57
  97.           20.1   Sharing DSZ Files.......................................  58
  98.           20.2   REGISTRATION............................................  59
  99.           20.3   Files on Registration Disk..............................  61
  100.           20.4   Bulletin Board Registration.............................  62
  101.  
  102.      21.  CHANGES........................................................  64
  103.  
  104.      22.  ACKNOWLEDGEMENTS...............................................  75
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                   Chuck Forsberg
  125.  
  126.                                Omen Technology Inc
  127.  
  128.  
  129.                                      ABSTRACT
  130.  
  131.  
  132.  
  133.                    ZMODEM-90(TM) - Not just another XMODEM hack
  134.  
  135.      DSZ is one of many available programs that implement the ZMODEM file
  136.      transfer protocol.  DSZ features the ZMODEM-90(TM) extensions including
  137.      ZMODEM compression and MobyTurbo(TM) accelerator.
  138.  
  139.      DSZ's ZMODEM provides advanced file management features including two
  140.      levels of Intelligent Crash Recovery(TM), and flexible control of
  141.      selective file transfers.
  142.  
  143.      The ZMODEM file transfer protocol provides reliable file and command
  144.      transfers with complete END-TO-END data integrity between application
  145.      programs.  DSZ's 32 bit CRC protects against errors that sneak by "error
  146.      free" modems and even the most advanced networks.
  147.  
  148.      ZMODEM safeguards all data and supervisory information with effective
  149.      error detection.  (XMODEM and many recently introduced protocols do not
  150.      protect vital supervisory data.)
  151.  
  152.      ZMODEM rapidly transfers files, particularly with modern modems,
  153.      timesharing systems, satellite relays, and packet switched networks.
  154.      ZMODEM's streaming operation eliminates delays caused by
  155.      Kermit/XMODEM/YMODEM/JMODEM block acknowledgements.  ZMODEM eliminates
  156.      traditional protocols' PACKET LENGTH compromises between transfer
  157.      efficiency and error recovery; ZMODEM's packet length is the entire
  158.      file.
  159.  
  160.      User Friendliness is an important ZMODEM feature.  ZMODEM
  161.      AutoDownload(TM) (Automatic file Download without user intervention)
  162.      provides a level of convenience unimaginable to users of traditional
  163.      protocols.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.        DSZ - a ZMODEM-90(TM), True YMODEM(TM), XMODEM File Transfer Program
  179.  
  180.  
  181.                                Omen Technology Inc
  182.  
  183.  
  184.      1.  ZMODEM Features at a Glance
  185.  
  186.      _______________________________________________________________________
  187.      |   Feature              | ProCm | RZSZ | DSZ  | GSZ | ZCOMM | Pro-YAM |
  188.      |________________________|_______|______|______|_____|_______|_________|
  189.      |Security Verification   | no    | no   | no   | no  | no    | YES     |
  190.      |Cybnertic Data Recovery | no    | no   | YES  | YES | YES   | YES     |
  191.      |                        |       |      |      |     |       |         |
  192.      |Command Download        | no    | YES  | no   | no  | YES   | YES     |
  193.      |                        |       |      |      |     |       |         |
  194.      |Update Directory Tree   | no    | YES* | no   | no  | YES   | YES     |
  195.      | Create Directories     | no    | YES* | no   | no  | YES   | YES     |
  196.      | Newer files Only       | no    | YES  | YES  | YES | YES   | YES     |
  197.      | Protect files          | ?     | YES  | YES  | YES | YES   | YES     |
  198.      | Common files Only      | no    | YES  | YES  | YES | YES   | YES     |
  199.      |                        |       |      |      |     |       |         |
  200.      |Collision Avoidance     | ?     | no   | YES* | YES | YES   | YES     |
  201.      |                        |       |      |      |     |       |         |
  202.      |Crash Recoverey         | YES   | YES  | YES  | YES | YES   | YES     |
  203.      | Verified Accuracy      | no    | SZ   | YES  | YES | YES   | YES     |
  204.      |                        |       |      |      |     |       |         |
  205.      |ZMODEM-90(TM)           | no    | YES  | YES  | YES | YES   | YES     |
  206.      | Compression            | no    | YES  | YES  | YES | YES   | YES     |
  207.      | MobyTurbo(TM)          | no    | YES* | YES  | YES | YES   | YES     |
  208.      | 7-bit Paths OK         | no    | YES* | YES* | YES | YES   | YES     |
  209.      |                        |       |      |      |     |       |         |
  210.      |OPERATING SYSTEMS       |       |      |      |     |       |         |
  211.      | Text Translation       | no    | YES  | YES  | YES | YES   | YES     |
  212.      | Record Format Support  | no    | YES  | YES  | YES | YES   | YES     |
  213.      | DOS Shared Files       | ?     | -    | YES  | YES | no    | no      |
  214.      | VMS                    | no    | YES  | no   | no  | no    | YES     |
  215.      | Unix/Xenix             | no    | YES  | no   | no  | no    | YES     |
  216.      |                        |       |      |      |     |       |         |
  217.      |True YMODEM(TM)         | no    | YES  | YES  | YES | YES   | YES     |
  218.      |Demand Upgrade(TM)      | no    | YES  | YES  | YES | YES   | YES     |
  219.      |File Transfer Display   | YES   | no   | no   | YES | YES   | YES     |
  220.      | TOTAL File Xfer Data   | no    | YES  | YES  | YES | YES   | YES     |
  221.      |________________________|_______|______|______|_____|_______|_________|
  222.  
  223.      ProCm = ProComm Plus
  224.      * Not available on all flavors or platforms
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.      Chapter 1 Pg 2        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  238.  
  239.  
  240.      *************************************************************************
  241.                            DSZ registration is special.
  242.      With most programs, registration only applies only to today's version.
  243.      Not DSZ!
  244.  
  245.      DSZ registration bypasses the shareware announcement and unlocks
  246.      advanced features in all future versions of DSZ.  You don't have to pay
  247.      and pay again for new DSZ versions.  Omen's Demand Upgrade(TM)
  248.      technology allows you to download and activate future DSZ versions
  249.      without further registration!
  250.      *************************************************************************
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      Chapter 2 Pg 3        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  297.  
  298.  
  299.      2.  TUTORIAL INTRODUCTION
  300.  
  301.      If you are just starting out with DSZ, or if you have difficulty getting
  302.      DSZ to work, please follow the procedure given below.
  303.  
  304.      Do not run any TSR or other COMM program.  This includes LAN programs.
  305.      Reboot a clean DOS if necessary.
  306.  
  307.      Start with the following command given directly from the DOS prompt:
  308.  
  309.                              dsz port 1 speed 2400 d t
  310.  
  311.      Type it exactly as it appears above; do NOT use upper case.
  312.  
  313.      (Change the port number and speed as necessary.  Use only COM1 or COM2
  314.      for testing.)
  315.  
  316.      This connects you to the modem.  Dial a bulletin board by typing AT
  317.      commands to the modem ("ATDT621-3746 <enter>")[1] to make it dial the
  318.      BBS.  Log in as usual.  Then, request a ZMODEM download of a file you
  319.      don't already have.  The file will download automatically, you don't
  320.      have to do anything.  This procedure verifies the correct operation of
  321.      DSZ.
  322.  
  323.      Next you might try calling the BBS using a higher "baud rate".  This
  324.      requires setting a higher speed with the "speed" command.  A "handshake
  325.      on" command may be necessary along with commands to the modem to enable
  326.      hardware handshaking in the CTS and RTS leads.
  327.  
  328.      Perhaps you got some error messages before or during the download.  The
  329.      "ERROR MESSAGES" chapter explains all the commonly seen error messages
  330.      and suggests solutions to the underlying problems.
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.      __________
  343.  
  344.       1. If your modem has a non standard setting the ATDT621-3746 command
  345.          you type to the modem may not echo on the screen.
  346.  
  347.          If your telephone line requires pulse dialing, use ATDP621-3746 (DP
  348.          instead of DT).
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.      Chapter 3 Pg 4        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  356.  
  357.  
  358.      3.  CALLING DSZ FROM COMM PROGRAMS
  359.  
  360.      If you need to define a trigger string for automatic downloads, make the
  361.      program look for "Control-X B 0 0" without the spaces.
  362.  
  363.      It may be necessary to add the DOS command: SET COMSPEC=C:\COMMAND.COM
  364.      (change as needed) to your AUTOEXEC.BAT file to allow programs to call
  365.      DSZ.
  366.  
  367.      Note: NO SPACES in the SET command!
  368.  
  369.      Please note that dsz reads the hardware to get the speed.  The dsz speed
  370.      command is hardly ever needed when calling dsz from another program.
  371.  
  372.      3.1  USE AN INTERFACE PROGRAM?
  373.  
  374.      A number of third party programs have been developed to provide a
  375.      congenial interface to DSZ if you have enough memory to spare.  The
  376.      XFER, POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in
  377.      interfacing DSZ to ProComm's editor gateway.  Many of these support GSZ
  378.      as well.  These programs are available on many bulletin boards.
  379.  
  380.      Hint: the DOS PATH environment variable must include ProComm's directory
  381.      to allow POE to locate all the POE files,.  The POE files should be
  382.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  383.      variable is insufficient.
  384.  
  385.  
  386.      Calling DSZ with these programs requires more memory than calling DSZ
  387.      directly.
  388.  
  389.      3.2  MSKermit 3.xx
  390.  
  391.      The "push" command (^[p) in MSKermit 3.xx sends an XOFF character to the
  392.      modem before calling DOS.  Using this to activate DSZ's term mode with a
  393.      "dsz t" command causes most remote hosts to lock up.
  394.  
  395.      The remote host can be unwedged by using the dsz G command, or by
  396.      keyboarding XON (Ctrl-Q) from DSZ's terminal mode.
  397.  
  398.      You can add these macros to your MSKERMIT.INI file.  Courtesy Keith
  399.      Petersen W8SDZ
  400.  
  401.      define sx run dsz F port 2 G sx 1 2,define 1,define 2,
  402.      define rz run dsz F ha on port 2 G rz -r
  403.      define sz run dsz F ha bo port 2 G sz 1 2,define 1,define 2,
  404.      define t run dsz F ha on port 2 G t -r
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      Chapter 3 Pg 5        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  415.  
  416.  
  417.      3.3  PROCOMM PLUS
  418.  
  419.      It's easy to add DSZ to ProComm Plus 2.X.
  420.  
  421.      Datastorm has not licensed ZMODEM-90(TM) technology despite allegations
  422.      that DSZ is now "built in" to ProComm Plus version 2.  Many users of
  423.      ProComm Plus version 2.x use DSZ to get MobyTurbo(TM), Intelligent Crash
  424.      Recovery(TM), and other ZMODEM-90(TM) features.
  425.  
  426.      Make sure the DSZ program is in your search path.  If you don't see DSZ
  427.      announce itself when called from ProComm, DSZ is not in your search
  428.      path.
  429.  
  430.      Here are some handy settings for ProComm Plus.
  431.  
  432.      First, you may need to set the DOS environment before running ProComm.
  433.      Give these commands to DOS before running ProComm Plus.  (These lines
  434.      may be added to your AUTOEXEC.BAT file.)
  435.  
  436.      Note: NO SPACES in the SET command!
  437.      SET DSZPORT=2                   (Only needed for COM2)
  438.      SET DSZLOG=DSZ.LOG      (Only if you wish a log file)
  439.  
  440.      Then set ProComm's external protocol strings.  From terminal mode hit
  441.      ALT-S, then select the PROTOCOL OPTIONS menu item.
  442.  
  443.      From that menu select EXTERNAL PROTOCOL OPTIONS.  Then set ProComm's
  444.      external protocol strings to:
  445.      A- External protocol 1 upload filename:  ZMODEMU
  446.      B- External protocol 1 download filename: ZMODEMD
  447.      C- External protocol 2 download filename: ZMODEMMD
  448.  
  449.      The following batch files are included in the DSZ zipfile:
  450.      ZMODEMU.BAT (contains:  DSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9)
  451.      ZMODEMD.BAT (contains:   DSZ rz)
  452.      ZMODEMDR.BAT (contains:   DSZ rz -r)
  453.      ZMODEMMD.BAT (contains:   DSZ rz -mr)
  454.      ZMODEMAD.BAT (contains: DSZ t)
  455.  
  456.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  457.  
  458.  
  459.      *******************************************************************
  460.      Select the ZMODEM PROTOCOL OPTIONS menu and turn off Auto downloading!
  461.      *******************************************************************
  462.  
  463.  
  464.      When sending (uploading) files with ZMODEMU.BAT give the ProComm window
  465.      the full pathname (c:/foo/bar/file.ext) for *each* file not residing in
  466.      the current directory.
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.      Chapter 3 Pg 6        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  474.  
  475.  
  476.      When downloading files with one of the other batch files shown above,
  477.      Procomm will also prompt for parameters; just hit ENTER.  Or, you can
  478.      enter options such as "-mr" if they are't included in the batch file
  479.      itself.
  480.  
  481.      Once you've got the hang of things the "ProComm way", try the "dsz t"
  482.      command described above to give you automatic ZMODEM-90(TM) downloads
  483.      (Look Ma, no keystrokes!!!)..
  484.  
  485.      You can also set the editor hot key (ALT-A) or view program hot key
  486.      (ALT-V) by using the ALT-S "FILE/PATH OPTIONS" menu.  The strings for
  487.      these keys are long enough to store an entire DSZ command line without
  488.      need for a batch file.
  489.  
  490.      COM3 and COM4 on Procomm Plus are non standard; in case of difficulty
  491.      use COM1 or COM2, or use the portx command.
  492.  
  493.      DSZ may not operate properly when called from ProComm if ProComm has
  494.      files open at the time.
  495.  
  496.      A number of reports have been received of problems running DSZ from
  497.      ProComm Plus because of insufficient memory.  Please refer to the
  498.      subchapter on LOCKUPS.
  499.  
  500.      When running under ProComm's Host mode, failure to use the DSZ CON
  501.      command may cause ProComm to interfere with file transfers or lock up
  502.      the computer.
  503.  
  504.      EXAMPLE: DSZ CON sz %1
  505.  
  506.  
  507.      Hint: the DOS PATH environment variable must include ProComm's directory
  508.      to allow POE to locate all the POE files,.  The POE files should be
  509.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  510.      variable is insufficient.
  511.  
  512.  
  513.      3.4  Qmodem
  514.  
  515.      Changes in the Qmodem interface (arguments passed to the batch file) may
  516.      require changes in the batch files shown below, depending on which
  517.      version of Qmodem is used.
  518.  
  519.      If you need to define a trigger string for automatic downloads, make the
  520.      program look for "Control-X B 0 0" without the spaces.
  521.  
  522.      If you define a protocol with 'Z' as its letter, the latest Qmodem will
  523.      detect automatic ZMODEM downloads.  Defining an external 'Z' protocol
  524.      disables Qmodem's internal ZMODEM, allowing DSZ to be called.
  525.  
  526.      The following is based on a message from Mike Cody, sysop of HomePlate
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      Chapter 3 Pg 7        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  533.  
  534.  
  535.      313-385-9969 3/12/24/96 HST
  536.  
  537.      Go into Qinstall and go to frame 3 Directories. Then select External
  538.      protocols #3 I think. Now you will see a definition area to tell Qmodem
  539.      the Letter,batchfile combo to use.
  540.  
  541.      Now put Z in the letter definition, Zup.bat in the u/l batch zdown.bat
  542.      in the d/l batch, and Y in the batch protocol. Now save it at the menu
  543.      with f10 and S.
  544.  
  545.      Then go to DOS and create the following batch files in your Qmodem
  546.      directory...
  547.  
  548.      zdown.bat: DSZ port %2 rz -rr
  549.  
  550.      zmdown.bat: DSZ port %2 rz -mrr ((FOR MOBYTURBO!!))
  551.  
  552.      zmdown2.bat: DSZ port %2 est 0 %3 rz -mrr
  553.  
  554.      zup.bat: DSZ port %2 sz %4
  555.  
  556.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  557.  
  558.      These are the batch files that will be called by Qmodem.  If you did
  559.      everything right when you hit PGDN or PGUP you will see an external
  560.      protocol called Z) Zmodem in the box. For an easier time do a search for
  561.      either External.arc or maybe the string "Qmodem" in the file database as
  562.      there is a file with several external protocols and batch files
  563.      available in the Mahoney file section (EXEC-PC BBS).
  564.  
  565.      The following batch files for Qmodem are included in the DSZ zipfile:
  566.  
  567.      ZDOWN.BAT contains:     DSZ port %2 rz -rr
  568.      ZUP.BAT contains:       DSZ port %2 sz %4
  569.  
  570.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  571.  
  572.      A variation on the receive batch file:
  573.      c:elecomqmodem\*y.com ha slow est 0 %3 rz -mrr
  574.      A variation on the send batch file:
  575.      c:elecomqmodem\*y.com ha cts est 0 %3 sz %4
  576.  
  577.  
  578.      If Qmodem says "unable to allocate swap space": QMODEM 4.2 will swap all
  579.      but approx. 5K to memory or disk when you shell out to DSZ. Go into
  580.      QINSTALL and make sure that /O /R Optimum Shell and Disk Shell are both
  581.      set to ON.
  582.  
  583.      For older Qmodem versions (before 4.2) change the %4 in upload scripts
  584.      to %3.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Chapter 3 Pg 8        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  592.  
  593.  
  594.      3.5  TELIX
  595.  
  596.      Telix has an internal ZMODEM, but some users prefer to use DSZ for
  597.      performance and/or reliability reasons.  Mat Fisher has published a
  598.      Telix script to call DSZ for automatic downloads.
  599.  
  600.      For those of you who use DSZ with Telix, here is a sample script
  601.      file to use instead of batch files:
  602.  
  603.      //////////////////////////////////////////////////////////////////
  604.      //Protocol salt file for Telix's external protocols by Matt Fisher
  605.      //Last edited (02/24/90)
  606.      //used for the DSZ ZMODEM protocol.  (for u/ling & d/ling)
  607.      //////////////////////////////////////////////////////////////////
  608.  
  609.      str upload[80] = "c:\telix\DSZ port 1 ha on sz -m -rr ";
  610.  
  611.      str download[80]= "c:\telix\DSZ port 1 ha on rz -b -m -rr ";
  612.  
  613.      //////////////////////////////////////////////////////////////////
  614.  
  615.      Main ()
  616.      {
  617.       if (_ext_filespec == "")
  618.        { strcat(download,_down_dir); dos(download,0); }
  619.       else
  620.        { strcat(upload,_up_dir); strcat(upload,_ext_filespec); dos(upload,0); }
  621.      alarm(1);
  622.      }
  623.      //////////////////////// THE END //////////////////////////////////
  624.  
  625.      Simple but effective...
  626.      --- TAGMAIL v2.20
  627.       * Origin: CRIMP/John Galt [Node 1] (1:120/144)
  628.      INTERNET: Matt.Fisher@f144.n120.z1.FIDONET.ORG
  629.  
  630.      NOTE: The DSZ command strings given above are quite unusual.  Instead of
  631.      the  "pW1  ha  off"  one  would be more likely to use "ha on" or "ha sw"
  632.      depending on the modem's flow control settings.
  633.  
  634.  
  635.         From : Bill Logan
  636.      Subject : Help With Gsz For Telix
  637.  
  638.      I test and use a variety of terminal programs for individuals.
  639.      One of which is telix.  I found the script language to be less
  640.      than user friendly and installed GSZ via batch files and as an
  641.      external protocol.  Here are the batch files:
  642.  
  643.      ZMUP.BAT
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.      Chapter 3 Pg 9        DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  651.  
  652.  
  653.      GSZ pV1 port %2 sz -mr %3
  654.  
  655.      ZMDN.BAT
  656.  
  657.      GSZ pV1 port %2 rz -mrr %3
  658.  
  659.      Then go to ALT O in Telix and insert those batch names in the protocols.
  660.  
  661.      They worked fine for me.
  662.  
  663.      Bill
  664.  
  665.      ---
  666.       * Origin: PCConsultingAgencyII {=Telecom Node=} (1:300/22)
  667.  
  668.      Use the Telix ALT-O screen to disable Telix's automatic ZMODEM download.
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.      Chapter 4 Pg 10       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  710.  
  711.  
  712.      4.  BULLETIN BOARD CONSIDERATIONS
  713.  
  714.      Note to the wise BBS operator: be sure you understand the restrict
  715.      command, how and WHY to use it!
  716.  
  717.      When installing DSZ on a bulletin board or host system, be sure to check
  718.      for proper operation when the caller hangs up while a file is being sent
  719.      or received.
  720.  
  721.      Some bulletin boards do not call DSZ to send a file until they have
  722.      verified the file's presence by actually opening the file.  If this
  723.      checking is done in DOS's default exclusive open mode, dsz's file
  724.      sharing will be defeated.
  725.  
  726.      If using a FOSSIL driver, you may need to call DSZ thru a batchfile.
  727.      That file should call XU to disable X00 before running DSZ and restart
  728.      X00 afterwards. Failure to take this precaution may cause FOSSIL to
  729.      steal the COM port from DSZ before file transfers are completed.
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.      Chapter 5 Pg 11       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  769.  
  770.  
  771.      5.  DESCRIPTION
  772.  
  773.      DSZ is a "protocol driver" that uses ZMODEM-90(TM), True YMODEM(TM), or
  774.      XMODEM to transfer files over a serial port with a variety of programs.
  775.  
  776.      DSZ has two main commands for ZMODEM transfers: "sz" sends file(s), and
  777.      "rz" receives them.
  778.  
  779.      When calling bulletin boards to download files with ZMODEM you can avoid
  780.      the bother of starting DSZ for each transfer by DSZ's terminal emulator,
  781.      before asking the BBS for the download.
  782.  
  783.                              dsz t
  784.  
  785.      The "t" command allows you to keyboard the file request directly to the
  786.      BBS.  (The "t" stands for "terminal emulation".) Just give the "dsz t"
  787.      command from DOS or your comms program's DOS GATEWAY.  DSZ's ZMODEM
  788.      AutoDownload then receives the file automatically, using the filename
  789.      provided by the BBS, without any wasted keystrokes or delay.  Try it,
  790.      you'll like it!  (The "t" command is described below.)
  791.  
  792.      YMODEM downloads are almost as easy.  Use the "t" command as shown
  793.      above, and hit the F3 key after telling the board to download a file
  794.      with YMODEM.
  795.  
  796.      ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  797.      modification time.
  798.  
  799.      DSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes
  800.      mislabeled as ymodem) and CRC-16 with the sx -k and rc commands.
  801.  
  802.      DSZ is usually called from a communications or bulletin board program.
  803.  
  804.      DSZ uses its own modem I/O.  The original interrupt vector, UART parity,
  805.      and interrupt configuration are restored on exit.  The original state of
  806.      the 8259 interrupt mask bit for this vector is also restored on exit.
  807.  
  808.      DSZ uses DOS standard output (stdout) for messages.  DSZ never writes
  809.      directly to the screen.  DSZ expects its standard output to point to the
  810.      console, a logging file, or NUL, but never the modem port.  If dsz's
  811.      standard output is redirected to the modem (as with ProComm's Host mode
  812.      DOS shell), the combination will lock up the computer.  When necessary,
  813.      dsz's standard output can be redirected back to the console device with
  814.      the CON command.
  815.  
  816.      DSZ and GSZ automatically support Doorway 2.2 without extra commands.
  817.  
  818.      The RZ.BAT and SZ.BAT files are supplied for convenience when operating
  819.      under Doorway.  RZ.BAT allows calling programs that emit an "rz" command
  820.      to automatically start DSZ from the DOS command prompt.  SZ.BAT is a
  821.      convenient command interface that complements RZ.BAT.  You may modify
  822.  
  823.  
  824.  
  825.  
  826.  
  827.      Chapter 5 Pg 12       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  828.  
  829.  
  830.      SZ.BAT and RZ.BAT with your favorite options.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.      Chapter 5 Pg 13       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  887.  
  888.  
  889.      6.  COMMANDS
  890.  
  891.            ***********************************************************
  892.                                     NOTE WELL
  893.       Except as noted, all commands and options must be typed in lower case.
  894.                              DO NOT USE UPPER CASE!!
  895.                                Case is significant!
  896.            ***********************************************************
  897.  
  898.      Optional commands or arguments are shown in square brackets [].
  899.  
  900.      When used (in any combination), the A, CON, port, speed, handshake,
  901.      estimate, and d commands must be used in exactly this order.
  902.  
  903.      dsz [A] [CON] [F] [port N] [speed S] [handshake XX] [pxN... ] [z pxN...
  904.      ] [D] [d] [restrict] [G] command
  905.  
  906.      The shareware program DOORWAY 2.2 interfaces well with DSZ, and provides
  907.      many of the same functions, including the ability to run direct screen
  908.      writing applications remotely.  DSZ and GSZ automatically support
  909.      Doorway 2.2 without extra commands.
  910.  
  911.  
  912.      6.1  List of Commands
  913.  
  914.      CON   Redirect message output to the DOS "CON" (console) device,
  915.            overriding any previous redirections.  This is necessary to avoid
  916.            lockups caused by ProComm host mode.  Most programs do not require
  917.            this hack.
  918.  
  919.      F     Leave the 16550A UART FIFO enabled on exit.  Since DSZ has no way
  920.            to read the 16550A DMA mode and trigger level bits, these values
  921.            are not restored.
  922.  
  923.      port N select port N (n = 1,2,3,4,5,6,7,8, or 9) Default is 1 (COM1) or
  924.            whatever is read from the DOS DSZPORT dos environment variable.
  925.            COM11 to COM18 refer to the COM1 to COM8 ports on the PS/2.
  926.  
  927.            *****************************************************************
  928.                                           NOTE
  929.            Only COM1 and COM2 are standard on all PC compatible computers.
  930.            Multiple standards exist for COM3 and above, so use only COM1 or
  931.            COM2 when first installing DSZ.
  932.            *****************************************************************
  933.  
  934.            DSZ COM3 uses 3E8 and IRQ4.  DSZ COM4 uses 2E8 and IRQ3.
  935.  
  936.            DSZ COM7 uses 3E8 and IRQ5.  DSZ COM8 uses 2E8 and IRQ5.
  937.  
  938.            If you wish to use COM3 or COM4 and your computer is not wired as
  939.            shown above, you MUST use the "portx" command to specify the
  940.  
  941.  
  942.  
  943.  
  944.  
  945.      Chapter 6 Pg 14       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  946.  
  947.  
  948.            actual base address and interrupt vector.
  949.  
  950.            EXAMPLE: to use COM2:
  951.            dsz port 2 rz
  952.  
  953.            In multitasking operation, accessing a port used by another
  954.            running program will hang the machine.
  955.  
  956.  
  957.      portx base,irq[,divisor] To select an arbitrary port address and
  958.            interrupt vector, the portx command must be used instead of the
  959.            port command.  The portx command replaces the portcommand in the
  960.            same place on the command line.  Please refer to DSZBG.DOC
  961.            (provided on the Registration Diskette) or the Professional-YAM or
  962.            ZCOMM (ZCOMMDOC.ZIP) manuals for details on this command.
  963.  
  964.            When the portx command is used, dsz will indicate COM9.
  965.  
  966.            EXAMPLE: dsz portx 3e8,15 speed 19200 handshake on rz
  967.  
  968.            Newer UART chips can use raw bit rate sources up to 8 MHz or more,
  969.            more than 4 times as fast as the IBM standard 1.84320 MHz.  Some
  970.            386 and 486 machines support MobyBaud(TM) operation above 115200
  971.            bps.  To support a nonstandard bit rate source, multiply 5760 by
  972.            the new raw bit rate source frequency in MHz divided by 1.84320.
  973.  
  974.            EXAMPLE: dsz portx 3e8,15,57600 speed 19200 handshake on rz
  975.            supports the 18.432 MHz clock option on the Boffin Electronics
  976.            "WinSport II" 2 port serial board.  Your hardware configuration,
  977.            BIOS firmware, operating system, device drivers, and TSR programs
  978.            will determine the maximum useful speed.
  979.  
  980.  
  981.  
  982.      speed S Set the specified speed.  This command is rarely needed because
  983.            DSZ reads the port's current speed by default.  Please refer to
  984.            the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters
  985.            in DSZBG.ZOO or the ZCOMM or Pro-YAM manual for important
  986.            information about the speed command.
  987.  
  988.            Please study all the chapters of this document when using speeds
  989.            above 2400 bps.
  990.  
  991.            With standard clocking, DSZ supports a maximum speed of 115200.
  992.            Not all hardware can support that speed without errors.
  993.  
  994.  
  995.      handshake XX Enable one of several choices of hardware handshake.  (The
  996.            default is XOFF/XON software handshake).  This command is
  997.            documented in the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The
  998.            ZCOMM manual is available on all bulletin boards registered for
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.      Chapter 6 Pg 15       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1005.  
  1006.  
  1007.            DSZ or GSZ as ZCOMMDOC.ZIP.) On DSZ the "handshake" command may be
  1008.            abbreviated to "ha".
  1009.  
  1010.      D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  1011.            lost.  This may be used to prevent spurious events (phone ringing)
  1012.            from interfering with the calling bulletin board's recovery from
  1013.            carrier loss.
  1014.  
  1015.      d     Disables carrier dropout monitoring, for modems that do not
  1016.            properly drive the "Carrier Detect" input on the PC.  If you see a
  1017.            No Carrier Detect message, you need to give the d command.  Before
  1018.            using the d command, make sure you have the proper port
  1019.            selected!!!
  1020.  
  1021.  
  1022.      estimate length [speed] Use the specified length and/or optional
  1023.            specified effective transfer speed to estimate transfer time for
  1024.            the next file to be sent or received.  The length argument is
  1025.            mainly used with XMODEM downloads; YMODEM and ZMODEM normally
  1026.            transfer the file length in the filename packet.  The estimate
  1027.            command must come after any port, speed, or handshake commands.
  1028.  
  1029.            The estimate command does not affect actual throughput.  It only
  1030.            affects DSZ's prediction of how much time a file transfer will
  1031.            take.
  1032.  
  1033.            The following makes DSZ calculate file transfer times based on 290
  1034.            character per second throughput.  Some error correcting 2400 bps
  1035.            modems can attain this throughput when MobyTurbo(TM) is used.
  1036.  
  1037.            EXAMPLE: dsz port 2 speed 9600 estimate 0 2900 rz
  1038.  
  1039.  
  1040.  
  1041.            EXAMPLE: dsz port 2 speed 9600 estimate 0 2900 sz bigmama.zip
  1042.  
  1043.  
  1044.  
  1045.      pxN   Set numeric parameter x to N.
  1046.  
  1047.            DSZ has two sets of numeric parameters, a base set and a "zmodem"
  1048.            set.  Parameters in the base control such things as date stamping
  1049.            of files, error exit value, etc.  The "zmodem" numeric parameters
  1050.            control timeouts, window sizes, and other ZMODEM, YMODEM, and
  1051.            XMODEM protocol parameters.
  1052.  
  1053.            These parameters are mostly a subset of the Pro-YAM/ZCOMM numeric
  1054.            parameters, and are listed below.  They assume their defaults each
  1055.            time DSZ is called.  Without an argument, p displays the numeric
  1056.            parameters and their values.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.      Chapter 6 Pg 16       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1064.  
  1065.  
  1066.            EXAMPLE: dsz p
  1067.  
  1068.  
  1069.      z pxN Set zmodem numeric parameter x to N.  All further numeric
  1070.            parameter commands are taken as zmodem parameters.  The zmodem
  1071.            numeric parameters correspond to the Pro-YAM or ZCOMM "zmodem"
  1072.            parameters and rarely need changing.  These parameters assume
  1073.            their defaults each time DSZ is called.  Without an argument, z p
  1074.            displays the zmodem numeric parameters and their values.
  1075.  
  1076.  
  1077.      restrict Restrict incoming pathnames (YMODEM/ZMODEM) to the current disk
  1078.            and directory tree, and disallow modification or overwriting of
  1079.            existing files.  This command is vital for bulletin boards
  1080.            uploading files.  The restrict command causes partially received
  1081.            files to be deleted.  When DSZ is restricted, it will refuse to
  1082.            transfer files containing the string autoexec.bat and command.com
  1083.            in upper or lower case.  This provides some defense from malicious
  1084.            uploaded files.
  1085.  
  1086.            EXAMPLE: dsz restrict rz
  1087.  
  1088.  
  1089.      G     Send an XON character to the modem.  Useful when calling dsz from
  1090.            MSKermit to undo the XOFF sent by MSKermit.
  1091.  
  1092.            EXAMPLE: dsz port 2 G t
  1093.  
  1094.  
  1095.      t     [-T] [-8g] [-h] [-H] Terminal function with ZMODEM AutoDownload.
  1096.  
  1097.            The optional -T forces DSZ to exit after it has recognized a
  1098.            ZMODEM AutoDownload(TM) request.
  1099.  
  1100.            The optional -8g (available on registered copies only) enables
  1101.            reception of "BBS (ANSI) graphics" displays.  (A video device
  1102.            driver such as ANSI.SYS must be loaded to support some types of
  1103.            graphics.)
  1104.  
  1105.            The optional -h enables local echo of keyboarded characters ("half
  1106.            duplex").  In addition, -H makes the Enter key perform a local
  1107.            newline (CR/LF).
  1108.  
  1109.            A small subset of ZCOMM/Pro-YAM term function subcommands are
  1110.            recognized:
  1111.  
  1112.            Keyboard F1 or ALT-X to exit.
  1113.  
  1114.            F3 receives file(s) with True YMODEM(TM),
  1115.  
  1116.            ALT-P toggles parity between the 8n default and 8g (enables ANSI
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.      Chapter 6 Pg 17       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1123.  
  1124.  
  1125.            "graphics").
  1126.  
  1127.            ALT-H toggles two local echo ("Half Duplex") modes; the second
  1128.            displays a newline (CR/LF) when Enter is keyboarded.
  1129.  
  1130.            Keyboarded ASCII characters are sent to the modem.
  1131.  
  1132.            ALT-B sends a break.
  1133.  
  1134.            Characters from the modem print on the screen.  A device driver
  1135.            such as ANSI.SYS may be used to recognize escape sequences.
  1136.            Standard ANSI.SYS is limited to a small subset of ANSI escape
  1137.            sequences; NANSI.SYS, FANSI-Console and other replacement console
  1138.            drivers provide faster screen updates and better ANSI terminal
  1139.            emulation.
  1140.  
  1141.            DSZ's ZMODEM AutoDownload(TM) detects the start of a ZMODEM file
  1142.            download and accepts the file(s) without operator intervention.
  1143.  
  1144.      rz    [-abeEmMnpPrt+YZy] [dir] [file ...]     (ZMODEM-90 receive) **
  1145.  
  1146.      rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive) **
  1147.  
  1148.      rb    [-abt+y] [dir] [file ...]     (YMODEM receive) **
  1149.  
  1150.      rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive) **
  1151.  
  1152.      rc    [-abt+y] file1                (XMODEM/CRC receive)
  1153.  
  1154.      ro    [-abt+y] file1                (XMODEM OverThruster receive)
  1155.  
  1156.      rx    [-abt+y] file1                (XMODEM receive)
  1157.  
  1158.      rx -g [-abt+y] file1                (Qmodem-G receive) **
  1159.  
  1160.            ** Download directory specification and -g ignored w/o
  1161.            registration
  1162.  
  1163.  
  1164.      sz    [-abefnprtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file ...(ZMODEM
  1165.            send)
  1166.  
  1167.      sz    [-abeEfmMnpPrtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file
  1168.            ...(ZMODEM-90 send)
  1169.  
  1170.            Pathnames are separated by spaces.  Wildcards are OK.
  1171.  
  1172.            EXAMPLE: dsz port 2 sz -r /tmp/file1 /tmp/file3 *.c
  1173.  
  1174.  
  1175.            The "sz" and "sb" commands exploit DOS's tree structured file
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.      Chapter 6 Pg 18       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1182.  
  1183.  
  1184.            system.  A directory or disk specifier expands to all files in
  1185.            that directory.
  1186.  
  1187.            EXAMPLE: dsz port 2 sz -r C:srcdir
  1188.  
  1189.  
  1190.            If you use PREFIX= or ONAME= with the "sb" or "sz" commands, these
  1191.            pathnames must be entered in lower case unless the underlying file
  1192.            system supports upper AND lower case.
  1193.  
  1194.            EXAMPLE: dsz port 2 sz -r ONAME=newsrc.c temp.c
  1195.  
  1196.  
  1197.  
  1198.      sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM or YMODEM-g send)
  1199.  
  1200.      sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k or YMODEM-g
  1201.            send)
  1202.  
  1203.      sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  1204.  
  1205.      sx -k [-t] file1                    (XMODEM-1k send)
  1206.  
  1207.  
  1208.      v     Verify the serial number by writing a log entry (see DSZLOG).
  1209.  
  1210.            v      1     0 bps    0 cps   0 errors     0  128 s/n 666
  1211.  
  1212.            The letter "v" indicates a verification entry.  The first numeric
  1213.            field is 1 if YMODEM-g is supported.  The last field is the serial
  1214.            number.  Unregistered copies show a s/n of 0.
  1215.  
  1216.  
  1217.      o     Turn off Data Terminal Ready (DTR), terminating ("offing") the
  1218.            connection if the modem responds to DTR.  Useful with the "t"
  1219.            command to disconnect afterwards.
  1220.  
  1221.            EXAMPLE: dsz t o
  1222.  
  1223.  
  1224.  
  1225.      LARG  Convert ARG to lower case, then parse arg.
  1226.  
  1227.  
  1228.      The meanings of optional arguments to the file transfer commands are
  1229.      described in DSZBG.DOC and the ZCOMM/Pro-YAM manual.
  1230.  
  1231.      The s (SlugBait) option prevents a receiver from receiving a file
  1232.      without accounting for it.  Attempts to do so are flagged with a Q
  1233.      status in the log file.  This option can cause a transfer that
  1234.      legitimately fails near the end of the file to be reported as
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      Chapter 6 Pg 19       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1241.  
  1242.  
  1243.      Questionable rather than ERROR.  SlugBait causes DSZ to return success
  1244.      if at least one file is transferred.
  1245.  
  1246.      Send files may be specified indirectly:
  1247.                                dsz sz @C:files.lst
  1248.      sends the files in C:files.lst.  This provides another means of
  1249.      bypassing the DOS command line limit.  The first letter must be "@" and
  1250.      the third letter must be ":" to distinguish this from an ordinary
  1251.      pathname.  Pathnames in the indirection file may be separated by any
  1252.      combination of space(s), tab(s), CR and/or LF.  No spaces may appear
  1253.      inside a pathname; "FOO     .BAR" won't work.
  1254.  
  1255.      A list of files to send may be built up with a command like:
  1256.  
  1257.      EXAMPLE: dir/w *.zip > files.tmp
  1258.  
  1259.      This file must be edited to remove extraneous messages and unwanted
  1260.      files.  Then you send the files with:
  1261.      DSZ sz -m @c:files.tmp
  1262.  
  1263.  
  1264.      6.2  Interrupt Keys
  1265.  
  1266.      ALT-B Cancels the current ZMODEM session.  Normally this is the best way
  1267.           to cancel a ZMODEM session.
  1268.  
  1269.      ALT-F Skips the current file in ZMODEM transfers.
  1270.  
  1271.      Ctrl-Break Terminates the transfer in progress.
  1272.  
  1273.      ALT-N Abruptly terminates (NUKES) the transfer in progress.
  1274.  
  1275.      Ctrl-X If the local program is in its terminal function, typing a dozen
  1276.           Ctrl-X characters to the remote ZMODEM program terminates ZMODEM
  1277.           operations with most programs.  (Some machines do not allow ZMODEM
  1278.           programs to check for this.)
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.      Chapter 7 Pg 20       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1300.  
  1301.  
  1302.      7.  NUMERIC PARAMETERS
  1303.  
  1304.      DSZ uses the following main numeric parameters, settable with the pxN
  1305.      command.
  1306.  
  1307.      EXAMPLE: dsz pQ0 rz -rr
  1308.  
  1309.  
  1310.      **************************************************************************
  1311.      NOTE: Parameter setting commands such as "pd0" cannot be added to
  1312.      DSZOPT, they must be included in the command line.
  1313.      **************************************************************************
  1314.  
  1315.      In addition, DSZ uses the Pro-YAM/ZCOMM zmodem numeric parameters
  1316.      described in the Pro-YAM/ZCOMM reference manual (ZCOMMDOC.ZIP) and in
  1317.      DSZBG.DOC.
  1318.  
  1319.  
  1320.      B   Set the size of buffer used for disk reads and writes.  The default
  1321.          is 1024, 4096 maximum (16384 max on GSZ and DSZ.EXE).  If your copy
  1322.          of DSZ is running on a floppy disk system or a very slow turkey hard
  1323.          disk, a larger value may give better results.  Too large a value may
  1324.          exhaust memory, induce receiver timeouts, cause disconnects(!), or
  1325.          generate spurious CRC errors.  If performance logging doesn't work,
  1326.          this parameter is too big.
  1327.  
  1328.          EXAMPLE: dsz pB4096 sz A:floppy.fil
  1329.  
  1330.          Setting the buffer size may lock out the performance log, DSZFILES,
  1331.          and/or indirect pathname list in DSZ.COM.
  1332.  
  1333.          IF YOU AREN'T BLOODY SURE YOU NEED A BIGGER BUFFER, DON'T USE ONE.
  1334.  
  1335.          Please understand that the B parameter has nothing to do with
  1336.          anything you've heard about 128, 1024 or 8192 byte XMODEM style
  1337.          blocks.  Normally, ZMODEM's block size is the entire file!
  1338.  
  1339.      G   This parameter controls the number of bytes loaded into the 16550A
  1340.          transmit FIFO (First In First Out) storage register on each
  1341.          interrupt.
  1342.  
  1343.          For maximum efficiency, DSZ fills the 16 byte transmit FIFO when the
  1344.          UART generates a FIFO Empty interrupt.  Once loaded, data
  1345.          transmission from the transmit FIFO cannot be stopped, so many bytes
  1346.          may be sent after the modem sends XOFF or asserts hard flow control
  1347.          restraint.  Good engineering practice requires that modems accept a
  1348.          large number of bytes after asserting flow control restraint, but
  1349.          some modems and operating systems won't.
  1350.  
  1351.          This parameter is effective only with PCDOS machines using FIFO
  1352.          buffered UART devices.  To optimize dsz's responsiveness to flow
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.      Chapter 7 Pg 21       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1359.  
  1360.  
  1361.          control restraint, set this parameter to 0.
  1362.  
  1363.          EXAMPLE: pG0
  1364.  
  1365.  
  1366.      O   This parameter controls XMODEM OverThruster(TM).  It is described in
  1367.          DSZBG.DOC.
  1368.  
  1369.      P   After a "speed" command, if you give a p command (display
  1370.          parameters), the P parameter value will indicate the type of serial
  1371.          I/O UART chip detected.  DSZ automatically detects and enables the
  1372.          FIFO on the NS16550A, NS16550AFN, Goldstar GM82C550, and Intel 82510
  1373.          chips.
  1374.  
  1375.          EXAMPLE: dsz port 1 speed 19200 p
  1376.  
  1377.  
  1378.          0  Indicates a standard 8250 or 16450 UART with no special features.
  1379.  
  1380.          1  Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO.
  1381.             These are the preferred chips.
  1382.  
  1383.          2  Indicates an Intel 82510 with 3 deep receive FIFO.
  1384.  
  1385.          3  Indicates a Startech ST16C650 UART with 32 byte FIFOs and on chip
  1386.             hardware flow control support.
  1387.  
  1388.          The sequence "port 1 pP1 speed 19200" bypasses DSZ's verification
  1389.          checks normally performed on the FIFO configuration and may allow
  1390.          defective FIFO logic on certain chips to be used.  This incantation
  1391.          is not required for the NS16550AN or NS16550AFN.
  1392.  
  1393.          The sequence "pP-1 speed 2400" should be used with the Western
  1394.          Digital WD16550 chip to disable the brain damaged FIFO on that chip.
  1395.          The WD16550 FIFO has been observed to lose data when transmitting at
  1396.          2400 bps and slower speeds.  The minimum speed for normal transmit
  1397.          FIFO operation with the WD16C550 may vary with different computers.
  1398.  
  1399.  
  1400.      Q   Error code returned to DOS (default 1).  (Success always returns 0.)
  1401.          Some programs toss cookies when confronted with certain exit codes.
  1402.  
  1403.          EXAMPLE: dsz pQ-1 sz foo.bar
  1404.  
  1405.  
  1406.          DSZ reports an error if no files have been transferred, even if the
  1407.          command used wasn't supposed to transfer any file(s).
  1408.  
  1409.  
  1410.      R   If set to 1, causes partially received files to be deleted.
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.      Chapter 7 Pg 22       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1418.  
  1419.  
  1420.          EXAMPLE: DSZ pR1 rz
  1421.  
  1422.  
  1423.  
  1424.      S   Timeout in seconds (default 15) waiting for restraint release (XON
  1425.          and/or handshake).
  1426.  
  1427.      V   (DSZ.COM and GSZ only) Set this to 1 to use direct to screen video.
  1428.          This speeds up displays but may cause serial input errors when CGA
  1429.          equipped computers are used at high speeds.
  1430.  
  1431.          EXAMPLE: GSZ pV1 rz
  1432.  
  1433.          sets direct video output.
  1434.  
  1435.      W   Wait for Enter key before exiting after an error.  Useful when
  1436.          calling DSZ from DESQview, allows the window to close unless there
  1437.          is an error message that should remain visible.
  1438.  
  1439.          EXAMPLE: dsz pW1 sz foo.bar
  1440.  
  1441.  
  1442.      Y   Control byte for the NS16550AN/NS16550AFN FCR register.  If you
  1443.          don't know what the FCR does, don't mess with this parameter.  It
  1444.          has been suggested that a different value (129) may improve
  1445.          multitasking under DESQview when multiple copies of DSZ are active.
  1446.  
  1447.      a   Calibrates certain protocol timeouts used with XMODEM and YMODEM
  1448.          transfers (Cybernetic Data Recovery(TM)).  This parameter does not
  1449.          affect ZMODEM transfers.
  1450.  
  1451.          The a numeric parameter is automatically set to 2000 for a 4.77 mHz
  1452.          PC or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for
  1453.          a PS2/80.  If your computer has a speedup card or otherwise runs
  1454.          unusually fast (or slow!) for its type, you may set the a numeric
  1455.          parameter to a value that reflects its speed.
  1456.  
  1457.          EXAMPLE: dsz port 2 pa4000 rb
  1458.  
  1459.  
  1460.          NOTE: Setting this parameter does not suppress the "Unknown Machine
  1461.          Type" message which is displayed before the command line is scanned.
  1462.  
  1463.      d   A non zero value (the default) causes incoming files received with
  1464.          ZMODEM and full YMODEM transfers to have their Date set to that sent
  1465.          in the file header.  ZMODEM's file management features depend on the
  1466.          transmission of each file's modification date.  Files will have the
  1467.          same creation date, even if the two machines are in different time
  1468.          zones.  When transferring files to/from a Unix system, creation
  1469.          dates are interpreted according to GMT or Universal Coordinated
  1470.          Time.  File dating may be disabled with a pd0 command, which causes
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.      Chapter 7 Pg 23       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1477.  
  1478.  
  1479.          files to assume the date and time they were received.
  1480.          NOTE: Backdating file creation times may confuse some backup
  1481.          programs.
  1482.  
  1483.      v   Verbose level (debugging output) Negative values inhibit some
  1484.          routine messages.  Setting v to 1 or greater causes serialized
  1485.          copies to ring the bell when a transfer is done.
  1486.  
  1487.          EXAMPLE: dsz port 2 pv1 rz
  1488.  
  1489.  
  1490.      z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  1491.          transfers to coordinate the actual date of the file with computers
  1492.          in other time zones.  PDT or MST corresponds to 420.  This may be
  1493.          preset with the ZONE DOS environment variable.
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.      Chapter 8 Pg 24       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1536.  
  1537.  
  1538.      8.  ENVIRONMENT VARIABLES
  1539.  
  1540.      The following DOS environment variables may be set to modify DSZ
  1541.      operation.  DOS environment variables are set by giving a command to DOS
  1542.      before running DSZ.  You can add these commands to your autoexec.bat
  1543.      file.
  1544.  
  1545.  
  1546.      EXAMPLE: set DSZPORT=2
  1547.  
  1548.  
  1549.      The following form may be used for arbitrary address/vector
  1550.      combinations:
  1551.  
  1552.      EXAMPLE: set DSZPORT=3e8,4
  1553.  
  1554.      These DOS "set" commands may be placed in your AUTOEXEC.BAT file or
  1555.      given just before you run your communications program.
  1556.  
  1557.      IMPORTANT! Do not add spaces to these commands!!
  1558.      set DSZPORT  =  2 WILL NOT WORK!
  1559.  
  1560.  
  1561.      DIRRX (Registered copies only.) Specifies the directory to receive
  1562.          (download) files.  If the sting in DIRRX ends with "/", directory
  1563.          and/or disk designators in the incoming pathname are stripped, and
  1564.          only the stem (name and extension) is used.  Otherwise, if an
  1565.          incoming file has an absolute pathname, the incoming pathname is
  1566.          used.
  1567.  
  1568.          EXAMPLE: set DIRRX=C:/modem/download/dsz/
  1569.          dsz rz -r
  1570.          downloads files to the /modem/download/dsz directory on the C:
  1571.          drive, with ZMODEM Crash Recovery..
  1572.  
  1573.  
  1574.          EXAMPLE: set DIRRX=B:/
  1575.  
  1576.          The DOS "set" command defining the receive directory may be placed
  1577.          in your AUTOEXEC.BAT file.  Make certain there is enough environment
  1578.          space to hold this value.  Confirm this by typing "set" to the DOS
  1579.          prompt and verifying the DIRRX value is listed correctly.
  1580.  
  1581.      DSZFILES May contain a list of up to 9999 pathnames to transmit, with
  1582.          entries separated by spaces.  If present, DSZFILES is used in place
  1583.          of a normal command line list of files to send with the sb and sz
  1584.          commands.
  1585.  
  1586.          EXAMPLE: set DSZFILES=file1 file2 file3 *.c
  1587.          dsz port 2 handshake on sz -rr
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.      Chapter 8 Pg 25       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1595.  
  1596.  
  1597.          In practice, this string would be built up by a calling program and
  1598.          passed to DSZ with a "spawnvpe", "execvpe", or similar subroutine
  1599.          call.
  1600.  
  1601.          SEE ALSO: Pathname list specification @C:files.lst
  1602.  
  1603.      DSZLOG log file to receive entries for files sent and received.
  1604.          (Default null).  Sample entries:
  1605.  
  1606.      Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  1607.      Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  1608.  
  1609.          Transfer times are based on the DOS time of day clock and have up to
  1610.          two seconds' uncertainty.  As with all protocol throughput reports
  1611.          generated by Omen Technology programs (and contrary to the false
  1612.          claims of some critics), DSZ's throughput figures for ZMODEM,
  1613.          Kermit, and True YMODEM(TM) transfers do not take "credit" for
  1614.          pathname and/or protocol overhead characters.  DSZ's throughput
  1615.          reports do not include the time required to send the pathname.  This
  1616.          understates the true time required to transfer files, but the time
  1617.          required to send the pathname often depends on the alacrity of the
  1618.          operator, and thus does not always reflect the performance of the
  1619.          protocol itself.
  1620.  
  1621.          Transfers measuring less than one second are reported as having 9999
  1622.          characters per second throughput.
  1623.  
  1624.          The unlabeled numeric field after the error (retry) count is the
  1625.          number of flow control stoppages encountered sending the file.  Flow
  1626.          control restrictions are normal when the interface speed exceeds the
  1627.          communications speed (DTE > DCE).  This number gives an indication
  1628.          of flow control restrictions (overloaded networks, etc.) encountered
  1629.          during the transfer.
  1630.  
  1631.          The last numeric field before the file name is the YMODEM block size
  1632.          or ZMODEM subpacket length used for the last block in the file.
  1633.  
  1634.          The last field is the serial number of the other program, or -1 if
  1635.          this information is not available.  When sending files, the
  1636.          receiving program's serial number is not normally available unless
  1637.          the -S option is used.
  1638.  
  1639.          The code letter indicates the type of transfer, Z (ZMODEM), S
  1640.          (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by
  1641.          loss of data carrier).
  1642.  
  1643.          WARNING: If DSZ encounters a loss of carrier or other fatal error
  1644.          condition before a file COMMENCES transmission, a log entry may not
  1645.          be made.
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.      Chapter 8 Pg 26       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1654.  
  1655.  
  1656.          EXAMPLE: set DSZLOG=C:/yam/dszlog
  1657.  
  1658.  
  1659.          IMPORTANT! NO SPACES!!
  1660.  
  1661.  
  1662.      DSZOPT (Registered copies only) String containing default options for
  1663.          DSZ file transfers.  Legal option letters for DSZOPT are the
  1664.          optional modifiers to the DSZ sz, rz, sx, rx, sb, rb commands.
  1665.  
  1666.          A T may be appended to the string to force DSZ to exit after it has
  1667.          recognized a ZMODEM AutoDownload(TM) request.
  1668.  
  1669.          An 8g may be appended to the string to make BBS (ANSI) graphics the
  1670.          default for DSZ's t command.  The ability to preset these options is
  1671.          especially helpful for controlling ZMODEM automatic downloads from
  1672.          DSZ's t command.
  1673.  
  1674.          EXAMPLE: set DSZOPT=r
  1675.          Enables DSZ's Intelligent Crash Recovery(TM) as a default.
  1676.  
  1677.          Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the
  1678.          DSZ term function:
  1679.          set DSZOPT=r8g
  1680.  
  1681.  
  1682.          If you're downloading files from GEnie with an MNP modem, the
  1683.          following will speed up your downloads with Genie's ZMODEM-90Tm.
  1684.          (You can recognize ZMODEM-90 on GEnie two ways: 1) MobyTurboTm is
  1685.          used to speed ZIP and ARC downloads, 2) "sz 4.xx" is displayed at
  1686.          the end of transfer.  As of this writing, ZMODEM-90 may not be
  1687.          available in all libraries.) Note that (as usual with DSZ) case is
  1688.          significant: the "r" must be lower case, the "W" upper case.
  1689.          set DSZOPT=rW16384
  1690.  
  1691.  
  1692.          WARNING: Do NOT include "ena" or any other commands in the DSZOPT
  1693.          string.  With the exception of the "8g" mode, only **options** may
  1694.          be placed in the DSZOPT string!  (Options are the letters that
  1695.          modify the sz, rz, sb, etc. commands.  In "rz -r", "r" is an
  1696.          option.)
  1697.  
  1698.          Parameters can not be set in DSZOPT.
  1699.  
  1700.      MAXBYTES Maximum number of bytes allowed for transfer.  If this number
  1701.          is exceeded, DSZ skips the offending files (ZMODEM) or aborts
  1702.          remaining files in the batch (YMODEM).
  1703.  
  1704.      DSZPORT Default communications port override, default 1.
  1705.  
  1706.          EXAMPLE: set DSZPORT=2
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.      Chapter 8 Pg 27       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1713.  
  1714.  
  1715.          IMPORTANT! NO SPACES!!
  1716.  
  1717.  
  1718.  
  1719.      ZONE sets the z numeric parameter to the number of minutes the current
  1720.          local time lags GMT time.  PDT or MST corresponds to 420.  PST
  1721.          corresponds to 480.
  1722.          EXAMPLE:
  1723.          set ZONE=420
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.      Chapter 9 Pg 28       DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1772.  
  1773.  
  1774.      9.  EXIT STATUS
  1775.  
  1776.      DSZ exits with 0 status for successful transfers or the value of the Q
  1777.      numeric parameter (default 1) if a file transfer failed, or if no files
  1778.      were transferred.  Many languages and "door" programs do not return this
  1779.      information to the calling program.  Some languages and "door" programs
  1780.      freak out (hang) on certain non-zero exit values.
  1781.  
  1782.      A batch file that calls DSZ directly may be used to detect the DSZ exit
  1783.      status with the DOS "errorlevel" construct.  Please refer to the Q
  1784.      numeric parameter below for more information.
  1785.  
  1786.      DSZ's log file entries may also be examined to determine the success or
  1787.      failure of a file transfer.
  1788.  
  1789.      DSZ commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.
  1790.      The file transfer commands are fully described in ZCOMMDOC.ZIP, the
  1791.      ZCOMM User's Manual.  (ZCOMM is a full featured shareware communications
  1792.      program with autodialing, autolearn scripting, and terminal emulation.)
  1793.      Portions of the ZCOMM User's Manual are also provided in DSZBG.ZOO.  You
  1794.      may refer to one of those documents for details on the following
  1795.      commands.
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.      Chapter 10 Pg 29      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1831.  
  1832.  
  1833.      10.  EXAMPLES
  1834.  
  1835.      dsz sz c:foo.zip              (send 1 file with ZMODEM)
  1836.  
  1837.      dsz sz -m c:*.zip             (send all .ZIP files with MobyTurbo(TM))
  1838.  
  1839.      dsz sz f1.c f2.c f3.c         (send 3 files with ZMODEM)
  1840.  
  1841.      dsz sz c:foo.* b:*.c          (send multiple files with ZMODEM)
  1842.  
  1843.      dsz sz -Z *.lst               (send text files with ZMODEM compression)
  1844.  
  1845.      dsz sz -r bigone.zip          (CRASH RECOVERY: resume interrupted
  1846.      transfer)
  1847.  
  1848.      dsz rz -r                     (CRASH RECOVERY: resume interrupted
  1849.      transfer)
  1850.  
  1851.      dsz rz -rr                    (CRASH RECOVERY with file comparison)
  1852.  
  1853.      dsz handshake both sz yamdemo.zip       (Hardware+Software handshake)
  1854.  
  1855.      dsz sz -n *.*                 (send files that are newer or rx has no
  1856.      copy)
  1857.  
  1858.      dsz sz -Yn *.*                (Only send files that are newer than
  1859.      receiver's copy)
  1860.                                    (Do not send files that do not exist on
  1861.      receiver's disk)
  1862.  
  1863.      dsz rz C:/UPLOADS             (receive files to specified directory *)
  1864.  
  1865.      dsz port 2 speed 38400 handshake both restrict rz
  1866.                                    (Restrict provides protection for BBS's)
  1867.  
  1868.      dsz rz  -y prog.zip           (ZMODEM, single file pathname override)
  1869.  
  1870.      dsz pR1 rx foo.dat            (XMODEM receive, remove file if error)
  1871.  
  1872.      dsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP *)
  1873.  
  1874.      DSZ LRC L-Y NEWPROG.ZIP       (generate lower case "rc -y" command)
  1875.  
  1876.      dsz sz foo >debug.dmp         (Debugging data dump)
  1877.  
  1878.      dsz sz @C:/bbs/files.lst      (Indirect file list)
  1879.  
  1880.      dsz sz -u *.lst               (Unlink (Delete) files as they are sent)
  1881.  
  1882.      * Registered copies only
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.      Chapter 10 Pg 30      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1890.  
  1891.  
  1892.      11.  BACKGROUND OPERATION
  1893.  
  1894.      Three DESQview description files are provided to demonstrate background
  1895.      operation with modest (66 kb window) memory requirements.  DSZ uses
  1896.      tight C/ASM code, table driven CRC generators, and buffered receive and
  1897.      transmit for good performance in the background without hogging CPU
  1898.      cycles.  On a QIC Labs 8 mHz PC-AT clone, DSZ can download files in the
  1899.      background (3 background clock ticks, 9 foreground clock ticks) with a
  1900.      throughput better than 9600 bps.
  1901.  
  1902.      GSZ operates under DESQview with 128k of memory.
  1903.  
  1904.      HINT: make sure "Separate Shift State" is set to "N".
  1905.  
  1906.      2S   Prompts for file name(s) and sends them with ZMODEM protocol.
  1907.           File: 2S-PIF.DVP
  1908.  
  1909.      2T   Talks to the modem and allows manual YMODEM (F3) or automatic
  1910.           ZMODEM downloads.  File: 2T-PIF.DVP
  1911.  
  1912.      2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI
  1913.           CRT device driver to process ANSI screen codes.  File: 2A-PIF.DVP
  1914.           DS.BAT is the batch file used by 2A.
  1915.  
  1916.      These files are written for a port 2 local connection and \TMP
  1917.      directory, but may be modified to suit your requirements using the
  1918.      DESQview CP command.  The W numeric allows DESQview to close the window
  1919.      after DSZ finishes, providing a pleasant user interface.
  1920.  
  1921.      Other DVPs, Scripts, and Batch files are available on the DESQView
  1922.      conference on the Sound of Music as DVDSZ20Z.ARC.
  1923.  
  1924.      Please consult the DESQview documentation for instructions on
  1925.      installation procedure for the DVP files.
  1926.  
  1927.      Operation at high speed (above 9600 bps) may require the DESQview
  1928.      "Optimize communications" performance Advanced Setup option.
  1929.  
  1930.      Newer versions of DESQview may require more "common memory" allocation
  1931.      (6-8 k bytes) to operate with DSZ.  Some versions of DESQview do not
  1932.      operate properly with DSZ; DESQview 2.0 is known to work, and DESQview
  1933.      2.25 is reported to have fixed bugs in intermediate versions.
  1934.  
  1935.      On 286 and 386 machines, some DESQview operations involve swapping
  1936.      memory contents with buffers in extended memory.  As with extended
  1937.      memory ramdisks and disk caches, this causes errors with high speed
  1938.      communications.  The considerations discussed in the "286 and 386
  1939.      Extended Memory" subchapter apply here.  Since this DESQview extended
  1940.      memory swapping is asynchronous with respect to DSZ's file transfers,
  1941.      "handshake slow" doesn't help here.  The solution is to force DESQview's
  1942.      memory swaps to use smaller blocks (with interrupts allowed between
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.      Chapter 11 Pg 31      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  1949.  
  1950.  
  1951.      blocks) and/or use NS16550AN or NS16550AFN or Goldstar GM82C550 chips
  1952.      for the serial interface.
  1953.  
  1954.      If you see funny characters on the screen while a program is loading,
  1955.      you have a conflict between the display adapter and QEMM memory manager
  1956.      which may cause lockups.  If so you must explicitly exclude the display
  1957.      adapter's memory with an EXCLUDE clause in QEMM's config.sys entry.
  1958.  
  1959.            ***********************************************************
  1960.                                      WARNING
  1961.      When running DSZ under a multi tasking system such as DESQview, do not
  1962.      allow two programs to access the same comm port at the same time.  At
  1963.      best, such actions will disrupt communications.  At worst, your computer
  1964.      will attempt to open a subspace channel to V'ger.
  1965.  
  1966.      Tell DESQview to use the SPECIFIC port number you are using, and not "Y"
  1967.      to the question: "Uses serial Ports (Y, N, 1, 2)"
  1968.  
  1969.      When running a comm program under DESQview or any related multitasking
  1970.      executive, DSZ must be called directly from the comm program, in the
  1971.      same window.  DO NOT open a separate window for DSZ unless you were
  1972.      about to power down the computer anyway.
  1973.            ***********************************************************
  1974.  
  1975.      With some communications programs, you can make the call, log in, and
  1976.      then exit (closing the window) without disconnecting the modem.  At this
  1977.      time you can fire up DSZ with the "t" command to allow YMODEM or ZMODEM
  1978.      downloads in a small window.
  1979.      Example File: 2A-PIF.DVP
  1980.  
  1981.      Alternatively, you can start DSZ from the DOS prompt, then type "AT"
  1982.      commands to the modem to call the bulletin board.  DESQview's "learn"
  1983.      facility may be helpful here.
  1984.  
  1985.      11.1  Microsoft Windows
  1986.  
  1987.      Communications programs do not operate well under Windows 3 because
  1988.      Windows does not support true multitasking.  The severity of this
  1989.      interference depends on the version of Windows and what other programs
  1990.      are active or loading.
  1991.  
  1992.      For best results when running  in the MS-DOS shell, switch on the
  1993.      "Exclusive" and "Background" items in the "Settings" menu.  Also, bring
  1994.      up the "Control Panel" "386 Enhanced" menu, and set the "Minimum
  1995.      Timeslice" to a small value such as 2.
  1996.  
  1997.      This has been improved somewhat in WFG 3.11, a $50 upgrade from Windows
  1998.      3.1.
  1999.  
  2000.      OS/2 and Chicago provide better multitasking than Windows 3.1.
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.      Chapter 11 Pg 32      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2008.  
  2009.  
  2010.      11.2  VM
  2011.  
  2012.      According to Marshall Sutherland, Be sure to set IOPL3 mode to YES.
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.      Chapter 12 Pg 33      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2067.  
  2068.  
  2069.      12.  TERMINAL SERVERS
  2070.  
  2071.      Often users must use terminal servers or multiplexers to access Unix,
  2072.      VMS, and other timesharing systems.  Terminals on some timesharing
  2073.      systems are connected indirectly to the host with TERMINAL SERVERS
  2074.      operating over networks.  Terminal servers often interfere with file
  2075.      transfers by "eating" control characters and/or losing data.
  2076.  
  2077.      Accessing a distant system using telnet or rlogin on a local Unix system
  2078.      entails the same problems.  If you have a choice between telnet and
  2079.      rlogin try rlogin with the -8 option.  Set the escape character to ^P
  2080.      (control P) which is protected by ZMODEM.
  2081.  
  2082.      When terminal servers interfere with file transfers, server commands are
  2083.      often available to help the problem.  When possible, enable the server
  2084.      and modems for hardware flow control in and out.  Set the terminal
  2085.      server to telnet transparent mode.  Some typical commands are "SET
  2086.      TERMINAL DOWNLOAD", "set session passall", and "SET TERMINAL NO ESC",
  2087.      but there is no standard set of commands suitable for all terminal
  2088.      servers.  Normally these commands are given before attempting file
  2089.      transfers, but one user has reported that the command must be given
  2090.      after the file transfer is started(!).  Until terminal server vendors
  2091.      improve the quality of their product, you may have to get on their case
  2092.      until they adequately support high performance file transfers.
  2093.  
  2094.      Escaping control characters with ZMODEM (sz -e) may help if the transfer
  2095.      gets stuck in the same place on every attempt.  Professional-YAM and
  2096.      ZCOMM allow selection of which control characters need to be escaped.
  2097.      In extreme cases 7-bit transmission may be required (see the
  2098.      Professional-YAM/ZCOMM manual).  If you encounter problems with control
  2099.      characters you should identify which control characters are causing the
  2100.      problem.  Please refer to the sz -T command in sz.doc for more help.
  2101.  
  2102.      Flow control between the server and modem is often defective.  This
  2103.      rarely causes a problem in interactive applications whose short bursts
  2104.      (a screenfull at most) fit within the available memory buffers.
  2105.      Streaming protocols such as YMODEM-g, long packet SuperKermit, and
  2106.      ZMODEM can overload the available buffering.  Some terminal servers
  2107.      support commands to enable hardware flow control such as "TERM
  2108.      FLOWCONTROL HARDWARE IN OUT"; this assumes the modem attached to the
  2109.      server is properly configured.
  2110.  
  2111.      If the terminal server is too brain damaged to support flow control,
  2112.      ZMODEM lets you fake it by setting a window size.  Try
  2113.                                    sz -w2048 file...
  2114.      to enable software flow control.  Experiment with different window sizes
  2115.      for best results.
  2116.  
  2117.      Terminal servers are designed to accept keyboard input from human
  2118.      operators.  They may lose data when a program sends more data to the
  2119.      host faster than humans type.  Some servers allow larger input buffers
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.      Chapter 12 Pg 34      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2126.  
  2127.  
  2128.      to support file uploads.  If you can upload short files (less than 100
  2129.      bytes) but not longer files, try
  2130.                                    sz -w1024 file...
  2131.      with your uploading program.  (Not all programs support this option; use
  2132.      ZCOMM or Professional-YAM.)
  2133.  
  2134.      When both flow control and character transparency are problems, use
  2135.                                    sz -ew1024 file...
  2136.      as a starting point.
  2137.  
  2138.      Sometimes the terminal server software is defective and must be
  2139.      corrected.  Please contact the network's vendor for corrective
  2140.      procedures.  An alternative is to install direct serial ports for users
  2141.      desiring to upload files.
  2142.  
  2143.      We have also encountered problems when networking software fails to pass
  2144.      data after a large amount of data has been sent to the host.  This has
  2145.      happened on a PPP internet connection which prevented uploads of large
  2146.      amounts of data via either FTP or a ZMODEM upload (via TELNET).  The PPP
  2147.      connection grinds to a standstill and not even PING works.  The same
  2148.      ZMODEM/TELNET combination easily uploaded ten times as much to a nearby
  2149.      machine connected by Ethernet.
  2150.  
  2151.  
  2152.      12.0.1  PORT WATCHERS
  2153.      Some systems enforce a timeout which disconnects a user after several
  2154.      minutes of keyboard inactivity.  Long, error free ZMODEM transfers do
  2155.      not generate keyboard activity (this is why ZMODEM is so efficient).
  2156.      Restricting the window size with
  2157.                                    sz -w16384 file...
  2158.      option generates terminal input at regular intervals even when no error
  2159.      correction is needed.  If problems persist, try setting a packet length.
  2160.                                    sz -l1024 file...
  2161.      (The default ZMODEM packet length is the file length.)
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.      Chapter 13 Pg 35      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2185.  
  2186.  
  2187.      13.  FLOW CONTROL
  2188.  
  2189.      If you plan to send files over Telenet (PC-Pursuit), you must refer to
  2190.      the Pro-YAM or ZCOMM Reference manual (in ZCOMMDOC.ZIP) FLOW CONTROL
  2191.      chapter for vital information on flow control considerations necessary
  2192.      for proper operation of ZMODEM and other streaming protocols.  (ZCOMM is
  2193.      a full featured shareware communications program with autodialing,
  2194.      autolearn scripting, and terminal emulation.)
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.      Chapter 14 Pg 36      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2244.  
  2245.  
  2246.      14.  ERROR MESSAGES
  2247.  
  2248.      COM2 1200 bps Carrier Detect enabled Handshake slow
  2249.      Command line = (commands)
  2250.      This is a normal message displayed to help resolve problems with
  2251.      incorrect batch files.  The port number, speed, carrier detect
  2252.      ("enabled" or "DISABLED") and "handshake" indicate the selected mode of
  2253.      operation.
  2254.  
  2255.      DSZ FINISHED! exit code = 0
  2256.      This is DSZ's normal exit when at least one file has been transferred
  2257.      and no unrecoverable errors have been detected.  If an error such as a
  2258.      failed file transfer had been detected, the exit code would be 1, or the
  2259.      value set in the Q numeric parameter.
  2260.  
  2261.      As the message implies, DSZ has done all of its processing, and has
  2262.      return the communications port and vector to its original value before
  2263.      displaying this message.  If the computer locks up after this message is
  2264.      displayed, there's something wrong with the program that called DSZ, not
  2265.      with DSZ itself.
  2266.  
  2267.      Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM
  2268.      BIOS that does not follow the IBM specification for identifying the
  2269.      machine type.  If your computer causes DSZ to display this message, you
  2270.      may set the a numeric parameter described elsewhere in this document.
  2271.      This message is generated before any commands are read, so do not be
  2272.      alarmed when you "discover" that setting the a parameter doesn't make
  2273.      this message go away.  The a parameter does not affect ZMODEM transfers.
  2274.  
  2275.      Please send us a postcard or letter indicating the reported hex value
  2276.      for machine Type, name of the computer, and its speed so we can include
  2277.      that machine type in a future release.
  2278.  
  2279.      Need more memory to run DSZ or Abnormal program termination is displayed
  2280.      by the TurboC startup routine if DSZ is run in too small a memory
  2281.      partition.  If you see this message, use a larger memory partition for
  2282.      DSZ or remove some memory resident programs.  This message may also
  2283.      appear if the calling program fails to free memory before calling DSZ.
  2284.  
  2285.      No Carrier Detect is displayed when DSZ recognizes a lack of carrier
  2286.      detect signal from the modem.  Most support calls concerning "No Carrier
  2287.      Detect" are caused by the user failing to tell DSZ to use the correct
  2288.      port.  DSZ does not magically divine the COM port number; if the default
  2289.      COM1 is incorrect, DSZ must be told what port to use with the port
  2290.      command or the DPORT environment variable.
  2291.  
  2292.      The No Carrier Detect message may also be caused by a line disconnect,
  2293.      defective cable, or incorrect modem strapping.  Sometimes this is caused
  2294.      by setting the B parameter to too large a value.
  2295.  
  2296.      The No Carrier Detect message may be disabled with the d command.  The d
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.      Chapter 14 Pg 37      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2303.  
  2304.  
  2305.      command must be given after any port or speed commands.
  2306.  
  2307.      Garbage Count Exceeded Indicates ZMODEM has not detected a valid start
  2308.      of header in a reasonable number of characters.
  2309.  
  2310.      If DSZ becomes "stuck" on emitting this messages, it is possible the
  2311.      sending program may not be able to recognize and act upon transmission
  2312.      requests (ZROPS headers).  The sending program should be corrected.  In
  2313.      the meantime, setting a ZMODEM packet length with the "zmodem pl4096"
  2314.      ("l" is the small letter l) command will force the sender to wait for
  2315.      the receivers' progress reports.
  2316.  
  2317.      Permission denied comes from the Microsoft C Library.  This is caused by
  2318.      attempts to modify a read only file or directory, or to create a file in
  2319.      a nonexistent directory.
  2320.  
  2321.      Appearance of XOFF or FLOW during ZMODEM or YMODEM-g file sending
  2322.      signifies DSZ is responding to flow control restraint.  This is normal
  2323.      operation when error correcting modems or packet switched networks are
  2324.      used.  ZMODEM's robustness and reliability allow creative users to
  2325.      transfer files over unusual multiple hop computer lash-ups, causing
  2326.      modem data lights and computer status displays to dance in unfamiliar
  2327.      rhythms.
  2328.  
  2329.      Output FLow Control Restraint RELEASED Indcates DSZ has not received a
  2330.      positive flow control signal (XON and/or CTS as specified by the
  2331.      handshake command) within the timeout specified by the S numeric
  2332.      parameter.  This message may appear as the result of line noise.  If it
  2333.      appears often, it may indicate improper flow control settings, defective
  2334.      modem and/or cable, or (rarely) too small a value for the S numeric
  2335.      parameter.  A TSR program that monitors ring detect has also caused this
  2336.      problem.
  2337.  
  2338.      Not allowed to overwrite file.ext By default, DSZ will not overwrite an
  2339.      existing file.  Use the -y or -n or -r option to overwrite/update
  2340.      existing files.
  2341.  
  2342.  
  2343.      14.1  Got ZRPOS
  2344.  
  2345.      Got ZRPOS indicates the receiving program has detected a transmission
  2346.      error and has requested retransmission.  In other words, ZMODEM is doing
  2347.      its job of detecting and correcting missing and garbled data.
  2348.  
  2349.      If this happens with error correcting modems, or more often than
  2350.      observed line noise would suggest, the receiver's error messages must be
  2351.      studied.  "Line Status Register 01" messages indicate a flow control
  2352.      problem.  "Line Status Register 02" messages suggest a receiver problem
  2353.      with interrupt latency.
  2354.  
  2355.      Otherwise, the sender may have a flow control problem in one of four
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.      Chapter 14 Pg 38      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2362.  
  2363.  
  2364.      areas:
  2365.  
  2366.        + Between the sending program and its modem.  If using an interface
  2367.          speed higher than the transmission speed, or modem to modem error
  2368.          correction (MNP, LAPB, PEP, etc.), check that the modem and the
  2369.          sending program are configured for the same flow control methods.
  2370.          Omen Technology's software is faster than most other programs, and
  2371.          may expose flow control problems not seen with slower software.
  2372.  
  2373.        + Between the sending modem and the network.  Correcting this requires
  2374.          "handshake both" to allow the sending program to honor both hardware
  2375.          (CTS) flow control from the modem and software flow control
  2376.          (XON/XOFF) from the network.
  2377.  
  2378.        + Between parts of the network, or between the host computer and its
  2379.          terminal server(s).  We have received a number of reports of
  2380.          problems with Cisco terminal servers.
  2381.  
  2382.        + Between the receiving modem and the receiving program.  This can
  2383.          happen at high transmission speeds when the receiver has specified a
  2384.          large I/O buffer size with the B numeric parameter.
  2385.  
  2386.          Excessive interrupt latency from extended memory ramdisks or disk
  2387.          caches, and poorly written hard disk drivers also wreak havoc on
  2388.          streaming protocols but do not affect start-stop protocols (XMODEM,
  2389.          etc.).  Problems with extended memory disk caches may cause errors
  2390.          at regular intervals; check the receiver's error messages.
  2391.  
  2392.          To work around these problems, give the "handshake slow" command to
  2393.          the receiver.
  2394.  
  2395.  
  2396.      14.2  Subpacket too Long
  2397.  
  2398.      This error is often caused by flow control problems at the sender (see
  2399.      above).
  2400.  
  2401.  
  2402.      14.3  Bad CRC
  2403.  
  2404.      This error is often caused by flow control problems at the sender (see
  2405.      above).  If an odd Length is routinely reported, the cause is almost
  2406.      certainly incorrectly configured flow control at the sending end.
  2407.  
  2408.  
  2409.      14.4  Garbled Data Subpacket
  2410.  
  2411.      This error may be caused by flow control problems at the sender (see
  2412.      above).
  2413.  
  2414.      Byte NNNN retry M: <error message> These messages appear when the
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.      Chapter 14 Pg 39      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2421.  
  2422.  
  2423.      protocol has detected an error and is attempting to retransmit the
  2424.      garbled data.  These are normal messages.
  2425.  
  2426.  
  2427.      14.5  Serial Input Error: Line Status Register xx
  2428.  
  2429.      Serial Input Error: Line Status Register HH indicates a hardware
  2430.      problem, slow device driver, TSR program, or other software is disabling
  2431.      interrupts too long for the program to accept incoming data, and some
  2432.      characters are lost.  A slow response to flow control also triggers this
  2433.      message.
  2434.  
  2435.      The value of the line status register is displayed in HEX.  The
  2436.      following error conditions are OR'ed into the Line Status Register.
  2437.  
  2438.  
  2439.      01   The Interrupt level circular buffer has been overrun.  This
  2440.           indicates a flow control problem.  The remote did not respond to
  2441.           DSZ's XOFF or hardware flow control signal, and continued to send
  2442.           characters after being told not to.  This problem is alleviated by
  2443.           matching flow control between the sending computer, modems, and the
  2444.           receiving computer.  Usually, the mismatch exists between the
  2445.           sending computer and its modem.
  2446.  
  2447.  
  2448.      02   An 02 value (or any even number) for the LSR indicates Data
  2449.           Overrun.  "Data Overrun" means the computer was not able to respond
  2450.           to an incoming character from the UART (modem) in time to make room
  2451.           for the next incoming character.  Data Overruns are caused by
  2452.           poorly designed software and/or ROM BIOS "firmware" locking out
  2453.           interrupts for excessive periods.  These lockouts prevent the
  2454.           communications program from responding to the incoming characters
  2455.           in time to prevent data loss.
  2456.  
  2457.           Other chapters in this document give suggestions for working around
  2458.           excessive interrupt latency by using the NS16550AN or other
  2459.           buffered UART chips.  Please refer to the "Brain Damaged UARTS"
  2460.           subchapter.
  2461.  
  2462.           Please try all the suggestions mentioned here before contacting
  2463.           Omen Technology about data overruns.
  2464.  
  2465.           Common causes of excessively long interrupt lockouts ("critical
  2466.           code regions") are mouse drivers, disk drivers (BIOS), window
  2467.           managers (Windows 3 is terrible), disk cache programs including
  2468.           Microsoft SMARTDRV, TSR programs, and EGA/VGA board auto-select.
  2469.  
  2470.           Slowing the CPU to allow games and other time dependent programs to
  2471.           be used can generate excessive interrupt latency.
  2472.  
  2473.           Some BIOS routines are written without regard to their effect on
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.      Chapter 14 Pg 40      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2480.  
  2481.  
  2482.           high speed communications.  Better versions of the offending BIOS
  2483.           ROMS may be made available if enough users complain about poor
  2484.           performance.
  2485.  
  2486.           Interrupt latency caused by EGA/VGA board auto-select can be often
  2487.           corrected by disabling the board's Auto-Select.
  2488.  
  2489.           Device drivers and TSRs loaded in high memory sometimes cause
  2490.           interrupt latency problems that can be corrected by moving them
  2491.           into low memory.
  2492.  
  2493.           Poorly written disk caches and disk drivers cause interrupt latency
  2494.           that affects protocols.  Some disk cache programs can be set to
  2495.           cache disk reads only, avoiding the massive delayed writes that
  2496.           interfere with file downloads.  With Microsoft SMARTDRV.EXE, try
  2497.           using the /E option.
  2498.  
  2499.           Mouse drivers have been reported to cause loss of serial data.  If
  2500.           mouse movements interfere with file transfers, do not move the
  2501.           mouse when transferrng files.
  2502.  
  2503.           To correct Data Overruns, you must correct the offending
  2504.           condition(s) to allow the communications program to operate
  2505.           properly.
  2506.  
  2507.           The handshake slow command can be used to stop reception during
  2508.           disk transfers.  However, handshake slow is not always an effective
  2509.           alternative to correcting the real problem.  When using the
  2510.           handshake slow command, experiment with locking the modem to
  2511.           different speeds.  Sometimes a higher speed actually works better.
  2512.  
  2513.           The zmodem k numeric parameter can be set to flush the SMARTDRV
  2514.           cache under controlled conditions.  This may be used to reduce
  2515.           errors caused by SMARTDRV.  When used with SMARTDEV, set the zmodem
  2516.           k numeric parameter to the number of kilobytes the should be
  2517.           received before flushing SMARTDRV.  This number should be low
  2518.           enough to flush SMARTDRV before SMARTDRV periodically flushes
  2519.           itself.
  2520.  
  2521.  
  2522.           Downloading files temporarily to a RAMDISK may help.  Files on the
  2523.           RAMDISK must be copied to a real disk before they are safely
  2524.           stored.
  2525.  
  2526.  
  2527.           A CASE STUDY: NEC UltraLite VERSA The NEC UltraLite VERSA provides
  2528.           a case study of how brain damaged hardware and software interferes
  2529.           with high speed communications, and what can be done about it.  A
  2530.           NEC UltraLite VERSA with 8 MB of memory contains about 70 million
  2531.           transistors and costs upwards of $5000.  Unfortunately this machine
  2532.           lacks the hundred transistors necessary to buffer input on its
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.      Chapter 14 Pg 41      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2539.  
  2540.  
  2541.           built-in serial port.  This port is built in, so replacing it with
  2542.           a better UART ship is out of the question.  In normal operation
  2543.           interrupt latency caused by the NEC's device drivers and DOS cause
  2544.           errors at 38400 bps and above.
  2545.  
  2546.           Setting the zmodem k parameter to 50 or 100 reduced overruns by
  2547.           stopping transmission briefly before disk writes.
  2548.  
  2549.           The best operation was obtained by hitting the F5 key while DOS 6
  2550.           loads to bypass all device drivers and TSR programs.  Operating
  2551.           this way there were no data overruns (LSR 02 errors) at 38400 bps.
  2552.           Operation at 115200 bps was possible by setting a large I/O buffer
  2553.           and using the zmodem k numeric parameter.  I was able to download
  2554.           AM.DAT (a 15762427 byte FCC database of North American AM broadcast
  2555.           stations provided on the "Ham Call" CDROM) with 3471 cps throughput
  2556.           using ZMODEM compression.  While nowhere near as compressible as
  2557.           Columbia University's Kermit News compressible benchmark file, this
  2558.           highly compressible file provides a stress test for compressed
  2559.           transfers because of the resulting heavy disk I/O.
  2560.  
  2561.  
  2562.      08   Framing Error generally caused by line noise or an incorrect
  2563.           transmission speed ("baud rate") or format (number of bits).  Also
  2564.           caused by some cheap internal modems.  Most protocols require 8
  2565.           bits no parity (-8n) for proper operation.  This is set
  2566.           automatically by Omen Technology programs, but other programs may
  2567.           not be so smart.
  2568.  
  2569.  
  2570.      10   Break Interrupt generally caused by line noise or an incorrect
  2571.           transmission speed ("baud rate") or format (number of bits).  Also
  2572.           caused by some cheap internal modems.
  2573.  
  2574.  
  2575.      18   Framing Error and Break Interrupt (see above) in combination.
  2576.  
  2577.           This error may also be caused by defective 8250 UART chips.  Some
  2578.           internal modem cards have slow 8250 chips that do not operate
  2579.           properly with computers faster than 4.77 mHz.  Replacing the 8250
  2580.           with a NS16550AN is recommended.  Please refer to the "Brain
  2581.           Damaged UARTS" subchapter for details.
  2582.  
  2583.      Please refer to the In Case of Difficulty chapter of this document for
  2584.      solutions.
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.      Chapter 14 Pg 42      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2598.  
  2599.  
  2600.      14.6  TIMEOUT
  2601.  
  2602.      Indicates the other program is not responding or the phone line has
  2603.      disconnected.  If this message appears at the start of a transfer, you
  2604.      may be using the wrong speed.
  2605.  
  2606.  
  2607.      Less commonly encountered DSZ error messages are explained in the
  2608.      Professional-YAM manual.
  2609.  
  2610.  
  2611.      14.7  No Carrier Detect
  2612.  
  2613.      If you see a No Carrier Detect message, and you haven't lost the
  2614.      connection, you should fix your modem cable or modem settings to allow
  2615.      proper operation of the Carrier Detect signal (CD).
  2616.  
  2617.      A poorer alternative is to give the d command:  dsz port 1 speed 2400 d
  2618.      t
  2619.  
  2620.  
  2621.      14.8  Port %d (%X) defective
  2622.  
  2623.      When DSZ selects a serial port, it performs a quick hardware check to
  2624.      verify the presence and minimal functionality of the 8250 family UART.
  2625.      This message usually means a nonexistent port has been selected.
  2626.  
  2627.      Reports have been received of functional but nonstandard UART chips
  2628.      triggering this message.
  2629.  
  2630.  
  2631.      14.9  COMMAND NOT FOUND
  2632.  
  2633.      If you see this message, make sure DSZ is in the DOS PATH.  Sometimes
  2634.      this error is caused by having too many environment variable strings.
  2635.  
  2636.  
  2637.      14.10  Out of Environment
  2638.  
  2639.      means there is not enough room in the program environment to accept more
  2640.      data.
  2641.  
  2642.      DOS prints this message when it cannot allocate more memory to
  2643.      accommodate a "set" command, such as "set dirrx=c:/downloads/".
  2644.  
  2645.      Try moving the "set" commands to the batch file that calls your comms
  2646.      program, or to your AUTOEXEC.BAT file.
  2647.  
  2648.      To increase environment, use the /E switch. The default is 160 bytes.
  2649.  
  2650.      An example for your CONFIG.SIS file: SHELL=C:COMMAND.COM/E:256
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.      Chapter 14 Pg 43      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2657.  
  2658.  
  2659.      NOTE: Large environments may cause DSZ.COM to lockup.  This is less of a
  2660.      problem with DSZ.EXE.
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.      Chapter 15 Pg 44      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2716.  
  2717.  
  2718.      15.  SLOW TRANSFERS
  2719.  
  2720.      Some users report slower than expected file transfers even when few or
  2721.      no errors are reported.  Some possible causes are:
  2722.  
  2723.      If "handshake slow" is used, throughput may suffer.  Try one of the
  2724.      other solutions to the "Line Status Register = 02" errors discussed
  2725.      above.  When using "handshake slow" it may be possible to increase the
  2726.      modem's interface speed to 19200 bps or faster.
  2727.  
  2728.      Bad phone lines will silently slow MNP modems, sometimes without any
  2729.      error indications.  If the modems disconnect fairly often you should
  2730.      suspect marginal phone line conditions that are being hidden by MNP
  2731.      error correction.
  2732.  
  2733.      One of the programs may have set a parameter or option that acts to slow
  2734.      the transfer under certain conditions.
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.      Chapter 16 Pg 45      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2775.  
  2776.  
  2777.      16.  IN CASE OF DIFFICULTY
  2778.  
  2779.      16.1  LOCKUPS
  2780.  
  2781.      16.1.1  Insufficient Memory
  2782.      DSZ complains when it detects insufficient memory to operate.  When
  2783.      calling DSZ from another program, there may be ALMOST enough memory for
  2784.      proper operation, but DSZ locks up during a transfer or the calling
  2785.      program freezes after DSZ displays the "DSZ Finished" message.
  2786.  
  2787.      Sometimes there is a message about insufficient memory, sometimes just a
  2788.      lockup and no message.  To verify this problem, call CHKDSK from within
  2789.      your comms program (not from DOS!) by defining it as an external
  2790.      protocol.  If you use an interface program (Hotkeyz, Prodoor, etc.), you
  2791.      must call CHKDSK from that program, as those programs also reduce the
  2792.      memory available to DSZ.
  2793.  
  2794.      CHKDSK should report at least 64k free memory.  If less memory is
  2795.      reported, reduce the size of the COMMS program's capture buffer, or
  2796.      reboot the system with fewer/smaller device drivers and TSR programs.
  2797.      Calling DSZ directly from the comms program instead of from an interface
  2798.      also saves memory.
  2799.  
  2800.  
  2801.      16.1.2  Environment TOO BIG
  2802.      A large environment may cause DSZ.COM to lockup.  The size of the
  2803.      environment (the amount of text you get when you give the DOS "set"
  2804.      command) is subtracted from the data space available to 8086 C programs.
  2805.      This can be a problem with DSZ.COM, whose 8086 tiny model limits code,
  2806.      data, stack, and environment to 64 kb TOTAL.  Use DSZ.EXE (compiled with
  2807.      8086 small model) to alleviate this problem.
  2808.  
  2809.  
  2810.      16.1.3  Bad COM Port Configuration
  2811.      DSZ is fastidious about which interrupt vectors it takes over.  Unlike
  2812.      some programs, DSZ uses only the correct interrupt vector for its
  2813.      interrupt service routine.  (This allows multitasking.)
  2814.  
  2815.      DSZ obtains and releases this vector with standard DOS function calls.
  2816.      This allows multi line operation under DESQview and other multitasking
  2817.      systems.
  2818.  
  2819.      Incorrectly configured serial ports that work with programs that pig out
  2820.      both IRQ3 and IRQ4 will lock up with DSZ.  If DSZ locks up the machine
  2821.      as soon as it tries to send or receive data, this is usually the fault.
  2822.      Make sure the comm port is strapped correctly; COM1 uses IRQ4, COM2 uses
  2823.      IRQ3.  DSZ will lock up if the comm port is not properly set up.
  2824.  
  2825.      In addition, DSZ will not work properly if two devices are connected to
  2826.      the same IRQ line, even when some other programs (that don't use
  2827.      interrupts as intensively) do work normally on the same machine.  Make
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.      Chapter 16 Pg 46      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2834.  
  2835.  
  2836.      sure no other device uses the same IRQ as DSZ even if that device is not
  2837.      active.
  2838.  
  2839.      COM3 and above are not widely standardized.  If you have problems with
  2840.      COM3 or COM4, chances are your "COM3" is non standard.
  2841.  
  2842.  
  2843.      16.1.4  LAN Manager Conflicts
  2844.      Some Local Area Network (LAN) managers take over comm ports using code
  2845.      that interferes with DSZ.
  2846.  
  2847.      The following hint is from Tom Louvaris, LANtastic Sales/Support - New
  2848.      York.  Other LAN managers may require similar incantations to keep the
  2849.      LAN manager from messing with DSZ's comm port.
  2850.  
  2851.      Problem: When the lan is running, DSZ intermittently fails.  DSZ starts
  2852.      the transfer by displaying "Ready to send pathname".  The receiving
  2853.      system does noting.  Eventually, DSZ exits with code 1, and no file is
  2854.      sent.
  2855.  
  2856.      To release one or more Com Ports with LANtastic 3.x, enter the
  2857.      following...
  2858.  
  2859.              Net Queue Halt \Sever-name Comn
  2860.  
  2861.  
  2862.      Note: You must be logged on to "Server-name" with Queue privileges to
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.      Chapter 16 Pg 47      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2893.  
  2894.  
  2895.      enable the operation of this command.
  2896.  
  2897.      16.2  Incorrect Batch Files
  2898.  
  2899.      Incorrect batch files are the number one source of problems using DSZ
  2900.      for uploads and downloads.  Bulletin board programs with convoluted
  2901.      batch file mechanisms exacerbate the problem.
  2902.  
  2903.      DSZ's command line echo was added to assist in correcting defective
  2904.      batch files.  You should see a display like:
  2905.  
  2906.      Command line = 'rz '
  2907.      or
  2908.      Command line = 'port 2 speed 9600 sz foo.baz '
  2909.  
  2910.      You may have to add a "pause" command at the end of the batch file to
  2911.      allow DSZ's messages to be seen.  Another possibility is to turn on the
  2912.      printer with ^P before running DSZ, so DSZ's message can be saved on
  2913.      paper.
  2914.  
  2915.      In general, the Command line display should look like one of the
  2916.      examples in this document or those displayed by DSZ itself.  (The
  2917.      Command line display does not include the name of the DSZ program
  2918.      itself.)
  2919.  
  2920.      Try running DSZ by itself, without any batch files or TSR programs,
  2921.      calling it directly from DOS as described above.
  2922.  
  2923.  
  2924.      16.3  Cheap Internal Modems
  2925.  
  2926.      Numerous trouble reports have been received lately caused by cheap
  2927.      internal modems causing errors on ZMODEM transfers but not XMODEM.  A
  2928.      similar problem was experienced in the mid 80's during beta testing of
  2929.      some 2400 bps modems.  Perhaps defective LSI chips left over from those
  2930.      days were cloned or recovered from the trash bin.
  2931.  
  2932.  
  2933.      16.4  Commands Entered in Upper Case
  2934.  
  2935.      Most DSZ commands and options must be entered in lower case (small
  2936.      letters, not big letters).  Where the documentation or help screen
  2937.      indicates "rz", you must use "rz" and not "RZ".
  2938.  
  2939.  
  2940.      16.5  No Carrier Detect
  2941.  
  2942.      If you see a No Carrier Detect message, and you haven't lost the
  2943.      connection, you should fix your modem cable or modem settings to allow
  2944.      proper operation of the Carrier Detect signal (CD).
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.      Chapter 16 Pg 48      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  2952.  
  2953.  
  2954.      A poorer alternative is to give the d command:  dsz port 1 speed 2400 d
  2955.      t
  2956.  
  2957.  
  2958.      16.6  DOS 3.x
  2959.  
  2960.      DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS
  2961.      to prevent antisocial behavior. This is required on the NEC Multispeed,
  2962.      or if certain TSR's are used.
  2963.  
  2964.  
  2965.      16.7  Perstor Controllers
  2966.  
  2967.      Several reports have been received indicating Perstor disk controllers
  2968.      interfere with data communications.  Perstor is reportedly working on a
  2969.      fix.
  2970.  
  2971.  
  2972.      16.8  IBM PS/2 Model 50Z
  2973.  
  2974.      Early samples of this machine have a design error on the motherboard
  2975.      that causes comms programs to lock up the machine.  Replacing the
  2976.      motherboard with a correctly functioning unit from current production
  2977.      corrects the problem.  The part number of the replacement PS2/50 Z
  2978.      motherboard is 35F5928.  (Information provided by John M. Choma
  2979.      73047,3566) U.S. IBM stonewalled on this issue, but in December 1988
  2980.      agreed to replace the defective motherboards under warranty.
  2981.  
  2982.  
  2983.      16.9  Brain Damaged UARTS
  2984.  
  2985.      Omen Technology has received reports of problems with buggy 8250 type
  2986.      UART integrated circuits in Leading Edge modem boards, serial port
  2987.      interfaces, and computers.  The defective chip logic affects high
  2988.      performance software.  Replacing the buggy chip with a newer chip
  2989.      (NS16550AFN) corrects the problem.
  2990.  
  2991.      The UM82450 chip in the Zoom 2400HC also appears to cause problems.
  2992.      Zoom Telephonics advises that this problem is limited to their old
  2993.      model.  The old model has an external volume control.
  2994.  
  2995.      You can identify an old chip by inspecting the serial interface board
  2996.      for 8250 or UM82450 type devices.  A service technician or hardware
  2997.      hacker can help if you are not familiar with reading chip numbers.
  2998.  
  2999.      Dsz users can identify old chips with the following software command:
  3000.  
  3001.      EXAMPLE: dsz port 1 speed 2400 p
  3002.  
  3003.      The resulting value for the P numeric parameter should be 1.  A value of
  3004.      0 indicates a non-buffered chip or a chip with a defective buffer.
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.      Chapter 16 Pg 49      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3011.  
  3012.  
  3013.      ZCOMM and Professional-YAM users can look at the printout produced by
  3014.      the s command;  old UART chips register as TYP 0.
  3015.  
  3016.      Some internal modems and PCMCIA cards use a firmware simulated UART that
  3017.      is not detected as a buffered UART.  Properly designed firmware UARTs
  3018.      provide excellent buffering.
  3019.  
  3020.      The National Semiconductor NS16550AFN is a pin compatible plug in
  3021.      replacement for 8250 and 16450 serial chips.  Omen Technology PCDOS
  3022.      software enables the FIFO buffer in the NS16550AFN to prevents loss of
  3023.      data from poorly written device drivers, TSR programs, etc.
  3024.  
  3025.      We are also using the Goldstar GM82C550 chip with a 9025 date code.
  3026.      This Goldstar chip is plug compatible with the National chips.  No
  3027.      problems have been discovered with this chip.
  3028.  
  3029.      The NS16550AFN has better electrical characteristics than the older UART
  3030.      chips.  386 and fast 286 machines should use the NS16550AFN for best
  3031.      results.  Omen Technology software has been written to allow time for
  3032.      the older UART chips to operate. However, there is a limit to how much
  3033.      the software can rearrange chip accesses without resorting to
  3034.      performance robbing wait loops.  Some other software is not as forgiving
  3035.      of slow chips.
  3036.  
  3037.      Fortunately the FIFO UART chip situation continues to improve.  As of
  3038.      this writing, the following plug compatible chips are known to work.
  3039.  
  3040.         + Goldstar GM82C550,
  3041.  
  3042.         + National Semiconductor NS16550AN and NS16550AFN
  3043.  
  3044.         + Startech 16550
  3045.      Current Western Digital WD16C550 chips do not function properly at low
  3046.      speeds.
  3047.  
  3048.      The Startech 16C552 contains two UARTS and a buffered parallel
  3049.      interface.
  3050.  
  3051.      If your UART chip is soldered in or otherwise not replaceable, you will
  3052.      need a new plug-in board with a good UART chip.  Byte Runner
  3053.      Technologies 800-274-7897 offers a variety of boards and chips.
  3054.  
  3055.      Another is the KW-524E-1 Serial/Parallel/Game card, $30.90 from TSD
  3056.      Systems, 800-331-9130 (FAX 407-331-8130).  A board populated with two
  3057.      FIFO UARTS is $41.85.
  3058.  
  3059.      The Hayes ESP board comes with two serial ports with NS16550AFN devices.
  3060.      The ESP definitions for COM3 and COM4 agree with the industry standard
  3061.      definitions used by Omen Technology.  All option switches on the ESP
  3062.      board should be OFF except those used to select the port number (COMn).
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.      Chapter 16 Pg 50      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3070.  
  3071.  
  3072.      The $99 "WinSport II" from Boffin LTD 612-894-0595 has two NS16550AFN
  3073.      FIFO UARTS and also supports MobyBaud (18.432 MHz clock).  This card
  3074.      also supports higher IRQ numbers, freeing up the low IRQs for other
  3075.      applications.
  3076.  
  3077.      Software Electronics 503-640-1946 sells a $59 board with two FIFO UARTS
  3078.      and a bidirectional enhanced parallel port.
  3079.  
  3080.      The following information comes from a number of people:
  3081.  
  3082.      "I have located a small dealer in New York who has the cards with or
  3083.      without the 16550.  I believe the price is around $50.00.  The company
  3084.      is RJK Consulting and the number is 718-968-9167. The gentleman to speak
  3085.      to is a Mr. RJ Kulman. ...  I got this information off the "Interlink"
  3086.      BBS system." Fm: Nick Braak [TRICON] 75156,1254
  3087.  
  3088.      Fry's - 415-770-FRYS.  This is a Silicon Valley electronic department
  3089.      store.
  3090.  
  3091.      Jameco Electronics at 415-592-8097 800-538-5000 sells National
  3092.      NS16550AFN chips mail order (credit card) in small quantities.
  3093.      Unfortunately, we received a number of reports (none recently) that
  3094.      their serial i/o card was supplied with the defective WD16C550 soldered
  3095.      in, even when ordered with specific instructions to include 16550AFN
  3096.      chips.
  3097.  
  3098.      TSD Systems advertise a 2 serial/parallel/game card with one or two
  3099.      NS16550-AFN chips.  800-331-9130(voice) 407-331-8130(fax)
  3100.  
  3101.      Microprocessors Unlimited, 24000 South Peoria, Beggs, OK. (918) 267-
  3102.      4961. The price for the chip is $13.50 plus shipping costs.
  3103.  
  3104.      Consolidated Computers 4 Shoppers Lane Suite 121 Turnersville, NJ  08012
  3105.      (609)751-9595(voice) (609)751-3843(bbs) (609)751-3840(fax)
  3106.  
  3107.      Arrow Electronics at 800-932-7769 (516-467-1000).
  3108.  
  3109.      Willies Computer Software Company: 800/835-4832.
  3110.  
  3111.      N.B.: Current Western Digital WD16C550 chips do not function properly at
  3112.      low speeds.  This has been confirmed with samples received directly from
  3113.      Western Digital.  WD is aware of this problem, but has not informed us
  3114.      of a corrected chip.
  3115.  
  3116.  
  3117.  
  3118.      16.9.1  Everex Internal Modems
  3119.      Numerous reports have been received concerning difficulties with Everex
  3120.      modem cards.  Some of these cards contain buggy 8250 chips which are not
  3121.      up to the demands of full duplex streaming protocols such as ZMODEM.
  3122.      Replacing the buggy 8250 chip with NS16550AN chip corrects these
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.      Chapter 16 Pg 51      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3129.  
  3130.  
  3131.      problems.
  3132.  
  3133.  
  3134.      16.10  Weird Iron
  3135.  
  3136.      A few machines, some with V20 CPUs, reportedly don't like DSZ.COM.  We
  3137.      have not been able to repeat this; TeleGodzilla (using a V20) runs
  3138.      DSZ.COM without a hitch.  Switching to DSZ.EXE has cleared up the
  3139.      problems on other machines.
  3140.  
  3141.  
  3142.      16.11  PKARC 3.6
  3143.  
  3144.      It has been reported that PK36 grabs some interrupts and doesn't restore
  3145.      them on exit in an attempt to prevent hacks of the program.  Since
  3146.      eliminating that particular version and cleaning up memory, high speed
  3147.      transfers even with 8250 UARTS work properly again.
  3148.  
  3149.      The problem with PK 3.6 appears to be most severe if a BBS operator has
  3150.      doorware, etc that accesses the PK programs from a shell of some sort.
  3151.      This info may be helpful to users who are having otherwise inexplicable
  3152.      file transfer problems.
  3153.  
  3154.      Phil Katz has written me that this problem has been corrected in
  3155.      subsequent versions.
  3156.  
  3157.  
  3158.      16.12  Will the real YMODEM please stand up?
  3159.  
  3160.      Some XMODEM programs claiming to support YMODEM neither send nor accept
  3161.      the YMODEM pathname block.  1024 byte XMODEM is XMODEM-1k, not the
  3162.      YMODEM defined by Ward Christensen in 1985 when he invented the term
  3163.      YMODEM.  1987 and later versions of YMODEM.DOC remind the reader of the
  3164.      official YMODEM definition, which has not changed since YMODEM's coinage
  3165.      in 1985.
  3166.  
  3167.  
  3168.      16.13  286 and 386 Extended Memory
  3169.  
  3170.      Virtual memory disk caches and ramdisks using 80286 or 80386 extended
  3171.      memory require a kludge hardware reset of the CPU chip to return to the
  3172.      normal "real mode" after accessing extended memory.  This interference
  3173.      to the interrupt response time causes lost characters on comm ports, and
  3174.      may be minimized by specifying shorter memory transfers.
  3175.  
  3176.      Switching to a Goldstar GM82C550, National NS16550AN or NS16550AFN UART
  3177.      chip helps tremendously, allowing transfers at 115200 bps instead of
  3178.      9600 bps with a standard 8250.  Please refer to the subchapter on "Brain
  3179.      Damaged UARTs".  The DSZ "handshake slow" command may also help.
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.      Chapter 16 Pg 52      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3188.  
  3189.  
  3190.      16.14  Disk Caches
  3191.  
  3192.      Cache programs often interfere with ZMODEM transfers.  In one instance,
  3193.      replacing Microsoft's SMARTDRV.SYS with Multisoft's SUPERPCK.EXE helped.
  3194.      Norton NCACHE and and Multisoft PCQWIK have also caused errors.
  3195.  
  3196.      Some cache programs can be turned on and off; try turning it off when
  3197.      running DSZ.
  3198.  
  3199.      The current SMARTCACHE can be used to advantage by using "handshake
  3200.      slow" and the 'zmodem k" numeric parameter described in dszbg.doc.
  3201.  
  3202.      Switching to a National NS16550AN or NS16550AFN UART chip helps
  3203.      tremendously, allowing transfers at 115200 bps instead of 9600 bps with
  3204.      a standard 8250.  Please refer to the subchapter on "Brain Damaged
  3205.      UARTs".  The DSZ "handshake slow" command may also help.
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.      Chapter 17 Pg 53      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3247.  
  3248.  
  3249.      17.  ASSOCIATED DOCUMENTS
  3250.  
  3251.      Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS
  3252.      FOR FILE TRANSFERS" for descriptions of the file transfer options.
  3253.      (ZCOMM is a full featured shareware communications program with
  3254.      autodialing, autolearn scripting, and terminal emulation.) The "FILE
  3255.      TRANSFER BASICS" chapter explains the relative merits of XMODEM, YMODEM,
  3256.      ZMODEM, and other protocols and gives tips on their use.  The "MAIN
  3257.      COMMANDS" chapter describes the rb, rx, rc, rz, sb, and sz commands.
  3258.      The "MODEM INTERFACING" and "FLOW CONTROL" chapters contain important
  3259.      information on the use of buffered modems with DSZ.
  3260.  
  3261.      Information on the ZMODEM Inter Application File Transfer Protocol is
  3262.      available in Omen Technology's "ZMODEM DEVELOPER's COLLECTION" ($89.00).
  3263.  
  3264.      Unix/Xenix C Source code for XMODEM, YMODEM, and ZMODEM transfers
  3265.      to/from Omen Technology Products is included in RZSZ.ZOO.[1] This file
  3266.      includes a Pro-YAM/ZCOMM script to upload a bootstrap file to a Unix
  3267.      system, compile it, and (if the compilation is successful) upload the
  3268.      rz/sz source files.  (ZCOMM is a full featured shareware communications
  3269.      program with autodialing, autolearn scripting, and terminal emulation.)
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.      __________
  3297.  
  3298.       1. Technical support for rzsz is available on a paid consulting basis.
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.      Chapter 18 Pg 54      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3306.  
  3307.  
  3308.      18.  FILES
  3309.  
  3310.      Some of the batch files mentioned in this document are not included in
  3311.      the archives.  Those that are needed can be readily created with your
  3312.      favorite editor.
  3313.  
  3314.      DSZ.COM, DSZ.DOC, 2A-PIF.DVP, 2S-PIF.DVP, 2T-PIF.DVP, BBS_REG.TXT,
  3315.      DS.BAT, FIX.BAT, MAILER, ZMODEMAD.BAT, ZMODEMD.BAT, ZMODEMDR.BAT, and
  3316.      ZMODEMU.BAT constitute Omen Technology's DSZ.ZIP.  These same files are
  3317.      in DSZ.ZOO on the distribution diskette mailed to registered users.[1]
  3318.  
  3319.      2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, and 2T-PIF.DVP are used with Quarterdeck
  3320.      Office Systems' DESQview multitasking executive for background
  3321.      operation.  Their use is described in a previous chapter of this
  3322.      document.
  3323.  
  3324.      DGSZ.ZOO is distributed to GSZ registrants.  It contains GSZ.EXE and
  3325.      GCOLORS.EXE in addition to the above.
  3326.  
  3327.      ZCOMMDOC.ZIP (manual), ZCOMMEXE.ZIP (programs), ZCOMMHLP.ZIP (help
  3328.      processor and database), make up the ZCOMM communications tools
  3329.      shareware distribution.  The ZCOMM files are available on finer bulletin
  3330.      boards.  (ZCOMM is a full featured shareware communications program with
  3331.      autodialing, autolearn scripting, and terminal emulation.)
  3332.  
  3333.      RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE Unix/Xenix
  3334.      programs licensed for use transferring files to/from licensed Omen
  3335.      Technology products.[2]
  3336.  
  3337.      RZSZ.TLB The ZMODEM rz/sz programs are available in native VMS flavors
  3338.      with wild cards, record format support, etc..  Pre compiled VAX/VMS
  3339.      files are contained in the RZSZ.TLB compressed text library, available
  3340.      in the TeleGodzilla (503-621-3746) upgrade/vms subdirectory, Compuserve
  3341.      VAXFORUM, GEnie, and other bulletin boards.  The programs in RZSZ.TLB
  3342.      are part of the extra value provided by Omen Technology communications
  3343.      software.
  3344.  
  3345.      DSZ.EXE compiled with the Xenix to DOS XC may give moderately higher
  3346.      maximum throughput noticeable on slower machines.  Sending from a faster
  3347.      machine to an 8 MHz IBM AT with 16550AFN, using 115200 bps and "sz -yZ
  3348.  
  3349.  
  3350.      __________
  3351.  
  3352.       1. DSZ.ZOO is supplied to registrants instead of DSZ.ZIP because not
  3353.          all registrants have copies of unarchiving programs.  The
  3354.          registration disk includes a copy of BOOZ, a simple dearchiver for
  3355.          ZOO files.
  3356.  
  3357.       2. Technical support for rzsz is available on a paid consulting basis.
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.      Chapter 18 Pg 55      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3365.  
  3366.  
  3367.      rttypix":
  3368.  
  3369.      Program                       Throughput
  3370.  
  3371.      DSZ.EXE                       12735 cps
  3372.      DSZ.COM                       7164 cps
  3373.  
  3374.      ProComm+2.0                   5928 cps
  3375.  
  3376.      (Compare these speeds to those listed on Page 159 of the April 30, 1991
  3377.      issue of PC Magazine.  Results are even better with the compressible
  3378.      file used in the PC Magazine tests.)
  3379.  
  3380.      DSZ.EXE supports ZMODEM over 7 bit paths (E and P options), and
  3381.      specified control character quoting (-Q<string> option).  The DSZ.EXE
  3382.      requires somewhat more memory than DSZ.COM.  The maximum DSZ.EXE I/O
  3383.      buffer size available with the B numeric parameter is 16384.  DSZ.EXE is
  3384.      available in DSZEXE.ZIP and DSZEXE.ZOO.
  3385.  
  3386.      ZCOMM and Pro-YAM also run faster than DSZ.COM.  (ZCOMM is a full
  3387.      featured shareware communications program with autodialing, autolearn
  3388.      scripting, and terminal emulation.)
  3389.  
  3390.      DSZBG.ZOO contains DSZBG.DOC.  Part of the DSZ registration disk, this
  3391.      file provides background information on the ZCOMM/Pro-YAM commands
  3392.      provided in DSZ and GSZ.
  3393.  
  3394.      The ZOO archive format is a machine independent improvement on the PC-
  3395.      DOS specific .ARC format. The ZOO format has been precisely defined, and
  3396.      stable ZOO archivers/dearchivers are available on a wide variety of
  3397.      systems.
  3398.  
  3399.      BOOZ.EXE unpacks .ZOO archives.  BOOZ.DOC describes BOOZ.EXE.
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.      Chapter 19 Pg 56      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3424.  
  3425.  
  3426.      19.  Other Omen Technology Products
  3427.  
  3428.      19.1  Professional-YAM COMMS TOOLS
  3429.  
  3430.      Omen Technology makes Professional-YAM, a comprehensive comms program
  3431.      with unmatched power.  (Professional-YAM is a full featured commercial
  3432.      communications program with autodialing, autolearn scripting, and
  3433.      terminal emulation.) Flavors are available for PC-DOS, Unix, Xenix, and
  3434.      OS/2 Protected mode.  Unix source code is available under license.
  3435.  
  3436.  
  3437.      19.2  ZCOMM: Industrial Strength COMMS Shareware
  3438.  
  3439.      ZCOMM is a full featured shareware version with a $40.00 basic
  3440.      registration.  Registered DSZ users upgrading to ZCOMM get a free
  3441.      binder!
  3442.  
  3443.  
  3444.      19.3  ZMODEM Developer's Collection
  3445.  
  3446.      Omen Technology sells the "ZMODEM Developer's Collection" for $89.00.
  3447.      This diskette includes the most recent public domain versions of
  3448.      YMODEM.DOC, ZMODEM.DOC and the Unix/VMS rz/sz C source code for YMODEM
  3449.      and ZMODEM.  Porting to the intended application is the sole
  3450.      responsibility of the purchaser.  For many developers, this collection
  3451.      affords a significant labor savings in obtaining these materials.
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.      Chapter 20 Pg 57      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3483.  
  3484.  
  3485.      20.  FAIR PLAY
  3486.  
  3487.      Unlike snazzy menu interfaces, reliable high speed transfer protocols
  3488.      take many hours of testing, often over expensive phone connections, to
  3489.      develop.  Two decades of communications experience and protocol testing
  3490.      are distilled in DSZ.
  3491.  
  3492.      DSZ is a user supported program developed and supported by Chuck
  3493.      Forsberg, owner of Omen Technology.  Countless hours of work and
  3494.      expen$ive resources went to develop and support DSZ for the myriad
  3495.      environments users use it in.  The fact that most of the problems people
  3496.      encounter with DSZ are caused by other software, hardware problems,
  3497.      failure to read the supplied documentation, or pirating has not kept
  3498.      users from seeking and getting help, even if it means calling the author
  3499.      in the middle of his sleep.
  3500.  
  3501.      Beyond this, the world of communications is constantly evolving, and it
  3502.      requires a significant ongoing effort to keep DSZ and its documentation
  3503.      up to date with the current state of the art.  Individuals with little
  3504.      knowledge of the dynamic nature of telecommunications (or hidden
  3505.      agendas) have misrepresented the frequency of enhancements to DSZ as a
  3506.      sign that DSZ is "unstable" and unworthy of "serious consideration".  If
  3507.      you think such sniping is fair play, you are more than welcome to use
  3508.      one of the many other protocol programs available, each of which claim
  3509.      to offer speed and reliability comparable to DSZ.
  3510.  
  3511.      Non registered users are welcome to use DSZ for a reasonable evaluation
  3512.      period.  "Reasonable" means "until you've decided whether the program is
  3513.      worth $20.00." It does not mean "until some competing program gets
  3514.      around to adding ZMODEM or True Ymodem(TM)".  Once you've evaluated DSZ,
  3515.      ethical use of DSZ requires registering the copy.
  3516.  
  3517.      DSZ is not and never has been Public Domain.  Every version of DSZ has
  3518.      included a Copyright Notice and a prohibition against sale or
  3519.      modification.  There is no usage counter or other Trojan Horse in DSZ,
  3520.      but if you use this program, you have a moral and ethical obligation to
  3521.      register it.
  3522.  
  3523.      Paid registration enables t -8g, DIRRX, DSZOPT, OverThruster(TM),
  3524.      YMODEM-g, and other advanced features that are present in DSZ.ZIP in
  3525.      encrypted form.  The registration package serializes and decodes all
  3526.      past and future versions of DSZ.COM and DSZ.EXE.  You can get a fully
  3527.      featured upgrade of DSZ simply by downloading a newer version from
  3528.      ftp.cs.pdx.edu, TeleGodzilla (503-621-3746), BIX, GEnie (IBM
  3529.      Roundtable), CompuServe, and trusted bulletin boards.
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.      Chapter 20 Pg 58      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3542.  
  3543.  
  3544.      20.1  Sharing DSZ Files
  3545.  
  3546.      You are welcome to share unmodified copies of DSZ.ZIP or DSZ.ZOO with
  3547.      your friends and associates for their evaluation.  This documentation
  3548.      file and the MAILER file must be provided with all copies of DSZ except
  3549.      by prior written permission from Omen Technology Inc.  Because of piracy
  3550.      problems, Omen Technology must INSIST that DSZ be distributed only as
  3551.      part of the DSZ.ZIP file EXACTLY as provided by Omen Technology Inc, or
  3552.      in an archive which displays a CRC value for DSZ.COM equal to that shown
  3553.      in the Changes chapter.  If DSZ.ZIP is repacked, no files may be added
  3554.      to or removed from the archive.
  3555.  
  3556.      If you see an improperly packed or otherwise modified DSZ archive or
  3557.      parts thereof in a bulletin board, please ask the board's operator to
  3558.      replace such files with DSZ.ZIP exactly as provided by Omen Technology
  3559.      Inc.  Flame them until they behave ethically.
  3560.  
  3561.      Unmodified copies of Omen Technology shareware and demo files including
  3562.      GSZ.ZIP, DSZ.ZIP and DSZBG.ZIP may be distributed by "shareware
  3563.      distributors" provided 1) the files are clearly identified as
  3564.      unregistered shareware, 2) the cost of the distribution is nominal.
  3565.      Otherwise, no version of DSZ may be sold without the prior written
  3566.      permission of Omen Technology Inc.
  3567.  
  3568.      DSZ is not and never has been Copy Protected.  "DSZ unprotect" files
  3569.      have no function whatsoever except to aid and encourage the theft of
  3570.      Omen Technology's Intellectual Property.
  3571.  
  3572.      Distribution or use of programs or procedures that modify, patch,
  3573.      disassemble, decompile, or otherwise reverse engineer DSZ without the
  3574.      prior written permission by Omen Technology Inc is a bloody theft of
  3575.      intellectual property and services and is a violation of Federal
  3576.      Copyright Law.  The same applies to debug scripts and documentation
  3577.      written for the same purposes.  These perform the same function as
  3578.      pirate satellite and/or cable descramblers, to obtain benefit from
  3579.      encrypted communications without proper payment.  Piracy has been
  3580.      investigated by the FBI and prosecuted under federal statutes.
  3581.      Applicable law provides for damages and recovery of attorney's fees.
  3582.      Omen Technology has received reports of serious problems caused by
  3583.      unauthorized patches to DSZ, and cannot assume liability for the
  3584.      performance of the resultant code.  So far, none of the slime producing
  3585.      such bilge have seen fit to sign their real name and address to their
  3586.      cretinous attempts at ego gratification.
  3587.  
  3588.      Distribution of DSZ in any medium without this documentation file is an
  3589.      unauthorized modification to DSZ that deprives the rightful author of
  3590.      registration revenues.  That is a theft of intellectual property.  Such
  3591.      distribution damages the author by forcing the user and author to waste
  3592.      time and phone bills scrounging for the documentation, and answering
  3593.      questions that are fully covered in the documentation.
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.      Chapter 20 Pg 59      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3601.  
  3602.  
  3603.      If any version of DSZ is distributed with any other product, software or
  3604.      hardware, the product documentation must clearly and prominently state
  3605.      that the customer's continued use of DSZ requires registration directly
  3606.      with Omen Technology or its duly authorized agent(s).  When unregistered
  3607.      copies of DSZ are distributed on disk, a contemporary copy of
  3608.      ZCOMMDOC.ZIP should be included on the same disk.
  3609.  
  3610.      Thank you for your support.
  3611.  
  3612.      20.2  REGISTRATION
  3613.  
  3614.      After a short evaluation period, ethical users must register their copy
  3615.      of DSZ with a check for $20.00 in U.S. funds sent to:
  3616.  
  3617.             Omen Technology Inc.
  3618.             P.O. Box 4681
  3619.             Portland, OR 97208
  3620.  
  3621.      The address on your check is sufficient, no need to fill out forms.
  3622.  
  3623.             For VISA/MC Registrations, you can also:
  3624.             Call VOICE: 503-621-3406
  3625.  
  3626.             Or register online: 503-621-3746  300-1200-2400-9600 bps
  3627.             Or FAX the INSTANT MAILER to: 503-621-3735
  3628.  
  3629.      Don't bother scrounging for an envelope, just print the INSTANT MAILER
  3630.      included in this archive!
  3631.  
  3632.      Overseas registrations are sent out International Air Mail.  Users,
  3633.      especially those overseas, may choose to register their copy of DSZ for
  3634.      $25.00 U.S.  by providing their VISA or Mastercard card number with
  3635.      expiration date and their name as it appears on their credit card.
  3636.  
  3637.      Purchase orders for less than $150 must be prepaid.  Omen Technology Inc
  3638.      Federal TAX ID #: 930858776 Oregon TAX ID #: 536565
  3639.       .ne 12
  3640.  
  3641.      "Das Recht zur Benutzung von DSZ in Deutschland, Oesterreich und der
  3642.      Schweiz erwerben Sie durch Bezahlung der Lizenzgebuehr von DM 57,00
  3643.      (incl. Mwst) an RzK
  3644.  
  3645.      Doris Koepke
  3646.      Bitzenstr. 11
  3647.      D-5464 Asbach
  3648.  
  3649.      Tel. 02683-4547, FAX 49 2683 4537, Telex 86 3705 rzk d, CIS
  3650.      [70126,1660]. Sie erhalten dann von dort sowohl die neueste Version, als
  3651.      auch Ihren individuellen Software-Key, mit dem Sie auch kuenftige
  3652.      Shareware-Versionen "aufschliessen", also die in der Shareware Version
  3653.      nicht zugnglichen Programmfunktionen nutzbar machen koennen, per Post.
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.      Chapter 20 Pg 60      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3660.  
  3661.  
  3662.      Die Benutzung nicht registrierter Versionen stellt einen Verstoss
  3663.      geltenden Rechts dar und wird strafrechtlich verfolgt."
  3664.  
  3665.  
  3666.      *************************************************************************
  3667.      The user registration package includes a printed serial number password
  3668.      (SNP) card.  The registration "care package" diskette contains the
  3669.      latest versions of the DSZ programs, additional user documentation, and
  3670.      the installation program which uses your personal SNP to enable advanced
  3671.      features and bypass the opening advertisement.
  3672.  
  3673.      The registration package unlocks the extra value in all past and future
  3674.      versions of DSZ.COM and DSZ.EXE.
  3675.      *************************************************************************
  3676.  
  3677.      The unique serial number on the registration card is registered to the
  3678.      user, and is acceptable proof of registration to corporate auditors.
  3679.  
  3680.      The putsnp program inserts your unique DSZ Serial Number Password (SNP)
  3681.      into you copy of DSZ with the following command:
  3682.             putsnp dsz.com
  3683.      Putsnp prompts for your SNP and asks appropriate questions before
  3684.      inserting the SNP to enable the extra value in DSZ.
  3685.  
  3686.      GSZ is serialized with the GCOLORS program described above.
  3687.  
  3688.      Some TSR programs and device deivers interfere with putsnp.  If you have
  3689.      a lockup running putsnp, run it without any device drivers or TSR
  3690.      programs (boot a plain DOS from floppy disk).
  3691.  
  3692.      Your disk directory entry for DSZ will show the date and time you
  3693.      serialized your copy of DSZ.  This does not affect the revision date DSZ
  3694.      announces when DSZ is run.
  3695.  
  3696.  
  3697.      The only legitimate way to disable the opening advertisement in DSZ is
  3698.      to insert an authorized SNP obtained from Omen Technology into DSZ with
  3699.      the putsnp program.  Any other suppression or modification of the
  3700.      opening screen is an illegal, unethical theft of services.  Omen
  3701.      Technology has received reports of serious problems caused by
  3702.      unauthorized patches to DSZ, and cannot assume liability for the
  3703.      performance of the resultant code.
  3704.  
  3705.      Piracy is stealing.
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.      Chapter 20 Pg 61      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3719.  
  3720.  
  3721.      20.3  Files on Registration Disk
  3722.  
  3723.      The following files are currently included on the Registration Disk sent
  3724.      to paid registrants.
  3725.  
  3726.      BOOZ.EXE       Program to unpack .ZOO archives.  BOOZ.DOC describes
  3727.                     BOOZ.EXE.
  3728.  
  3729.  
  3730.      DSZEXE.ZOO     Contains DSZ.EXE.
  3731.  
  3732.                     To dearchive with booz: booz x dszexe
  3733.  
  3734.                     Type "booz" without arguments to see the help message.
  3735.  
  3736.  
  3737.  
  3738.      DSZ.ZOO        Contains DSZ.COM, DSZ.DOC, DESQview description files.
  3739.  
  3740.                     To dearchive with booz: booz x dsz
  3741.  
  3742.  
  3743.      DGSZ.ZOO       Contains GSZ, DSZ, GSZ.DOC, and DESQview description
  3744.                     files.
  3745.  
  3746.                     To dearchive with booz: booz x dsz
  3747.  
  3748.                     RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE
  3749.                     Unix/Xenix programs licensed for use transferring files
  3750.                     to/from licensed Omen Technology products.[1]
  3751.  
  3752.                     To dearchive RZSZ with booz: booz x rzsz
  3753.  
  3754.  
  3755.      PUTSNP.EXE     Installs your unique registered serial number to enable
  3756.                     the extra value in DSZ.  (GCOLORS is used for GSZ.)
  3757.  
  3758.  
  3759.      DSZBG.DOC      (in DSZBG.ZOO) Background information for GSZ and DSZ,
  3760.                     consisting of relevant parts of the ZCOMM User's Manual.
  3761.  
  3762.                     To dearchive with booz: booz x dszbg
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.      __________
  3769.  
  3770.       1. Technical support for rzsz is available on a paid consulting basis.
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.      Chapter 20 Pg 62      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3778.  
  3779.  
  3780.      20.4  Bulletin Board Registration
  3781.  
  3782.      Note to the wise BBS operator: be sure you understand the DSZ restrict
  3783.      command and how to use it.
  3784.  
  3785.      Use and/or copying of DSZ by bulletin board sysops and/or systems is
  3786.      allowed according to the following conditions:
  3787.  
  3788.      I agree to feature the ZCOMM files (ZCOMMEXE.ZIP, ZCOMMDOC.ZIP,
  3789.      ZCOMMHLP.ZIP) for downloading, and to announce the availability and
  3790.      features of ZCOMM in any bulletins, help displays, or other displays
  3791.      that mention communications programs.  It is my responsibility to
  3792.      maintain reasonably current versions of the ZCOMM files on the BBS shown
  3793.      above.
  3794.  
  3795.      I understand that I am welcome to use DSZ on my bulletin board(s) from
  3796.      the time I sign and mail this document as long as I abide by the
  3797.      conditions above, including featuring the above mentioned ZCOMM files.
  3798.  
  3799.      I shall distribute DSZ.COM only as part of the DSZ.ZIP EXACTLY as
  3800.      provided by Omen Technology Inc, or "zipped" without any file additions,
  3801.      deletions, or modifications.  If I distribute DSZEXE.ZOO, I shall also
  3802.      maintain DSZ.ZIP in the same directory since DSZEXE.ZOO references files
  3803.      in DSZ.ZIP.
  3804.  
  3805.      If I see a modified DSZ archive or parts thereof in a file or collection
  3806.      of files (e.g., archive) on a bulletin board, I shall replace such files
  3807.      or archive members with the contents of DSZ.ZIP exactly as provided by
  3808.      Omen Technology Inc.  I shall report instances of noncompliance to Omen
  3809.      Technology.
  3810.  
  3811.      I shall not allow any version of dsz to be sold, modified, patched,
  3812.      hacked, disassembled, decompiled, or otherwise reverse engineered
  3813.      without the prior written permission of Omen Technology Inc.
  3814.  
  3815.      I understand that DSZ is not and never has been Copy Protected.  I fully
  3816.      understand that "DSZ unprotect" files have no function whatsoever except
  3817.      to aid and encourage the theft of Omen Technology's Intellectual
  3818.      Property.
  3819.  
  3820.      (For this BBS registration, a multi node bulletin board operating from a
  3821.      single, common file system counts as one machine.)
  3822.  
  3823.      The purpose of bulletin board registrations is to support and promote
  3824.      ZCOMM and Professional-YAM by popularizing the ZMODEM protocol and
  3825.      featuring the ZCOMM shareware files available for downloading.
  3826.  
  3827.      BBS registrations must be submitted on the bbs_reg form with signature
  3828.      and date, and must accompany a new paid DSZ or ZCOMM registration.  The
  3829.      paid registration that must accompany your BBS registration can be one
  3830.      submitted by one of your board's users.  Most boards have many
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.      Chapter 20 Pg 63      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3837.  
  3838.  
  3839.      unregistered DSZ users, so getting one of them to register their DSZ
  3840.      should pose no difficulty.  Since the paid registration may be from one
  3841.      of your board's users, you can get your BBS registered for free by
  3842.      getting one of your users to register his/her DSZ at the same time.
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.      Chapter 20 Pg 64      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3896.  
  3897.  
  3898.      21.  CHANGES
  3899.  
  3900.      Be sure to save your serial number/password (SNP) card and the putsnp
  3901.      program you received from Omen Technology to use with future versions of
  3902.      DSZ you may download!  (Use GCOLORS to serialize GSZ.)
  3903.  
  3904.      Current GSZ and DSZ versions are maintained on EXEC-PC BBS, BIX, GEnie
  3905.      (IBM Roundtable), CompuServe (IBMCOM and CONSULT SIGs) as well as Omen's
  3906.      TeleGodzilla (503-621-3746).
  3907.  
  3908.      DSZ is a popular program which has been the object of virus attacks.
  3909.      Pirated/hacked versions of DSZ have cost users and DSZ's developer
  3910.      thousands of dollars in lost time and other expenses, in addition to
  3911.      injuring of Omen Technology's reputation.
  3912.  
  3913.      Virus and Trojan code hidden in hacked/pirated copies of DSZ and
  3914.      programs claiming to "register DSZ" have caused loss of data.
  3915.  
  3916.  
  3917.  
  3918.      -rw-r--r--   1 caf      omen       53934 Sep 20 15:47 dsz.com
  3919.      -rwxrwxr-x   1 caf      omen       61303 Sep 18 16:37 dsz.exe
  3920.      PKZIP -vt 32 bit CRC: 10E5C353   53934  dsz.com
  3921.      PKZIP -vt 32 bit CRC: AC7DE5EA   61303  dsz.exe
  3922.  
  3923.  
  3924.  
  3925.      Your copy of DSZ should show the same CRC values.  ZIP uses a 32 bit CRC
  3926.      compatible with the Professional-YAM and ZCOMM "crc" command.
  3927.            pkzip -vt dsz
  3928.      The following Pro-YAM/ZCOMM command gives the 32 bit CRC for DSZ.COM:
  3929.  
  3930.      EXAMPLE: >>>c: crc dsz.com
  3931.  
  3932.  
  3933.      If your copy shows a different CRC or file length, insist on a
  3934.      legitimate copy and report the source of the bogus/pirated copy to Omen
  3935.      Technology Inc.  Omen Technology has received reports of serious
  3936.      problems caused by unauthorized patches to DSZ, and cannot assume
  3937.      liability for the performance of the resultant code.
  3938.  
  3939.  
  3940.      COM7 and COM8 are changed; see the "port" command above.
  3941.  
  3942.      A problem in the 1/17/89 and 2/2/89 DSZ versions corrupts files under
  3943.      unusual circumstances.  Please delete all instances of the 1/17/89 and
  3944.      2-02-89 version.
  3945.  
  3946.      There never was a "zmodem d" parameter in DSZ.  Older versions of DSZ
  3947.      ignored attempts to set this nonexistent parameter with a message that
  3948.      humans ignored.  DSZ now aborts when asked to set a nonexistent
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.      Chapter 21 Pg 65      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  3955.  
  3956.  
  3957.      parameter.  There is a "d" parameter that controls time/date stamping of
  3958.      files; Bulletin boards that need to disable time/date stamping of
  3959.      received files should simply use "pd0" not preceded by a "z".
  3960.  
  3961.      Good news for tired frog stompers!  The ZMODEM rz/sz programs are
  3962.      available in native VMS flavors with wild cards, record format support,
  3963.      etc..  Pre compiled VAX/VMS files are contained in the RZSZ.TLB
  3964.      compressed text library, available in the TeleGodzilla (503-621-3746)
  3965.      upgrade/vms subdirectory, Compuserve VAXFORUM, GEnie, and other bulletin
  3966.      boards.  FTP access at ftp.cs.pdx.edu pub/zmodem/rzsz.tlb and Simtel20
  3967.      mirrors.
  3968.  
  3969.      The DSZ and GSZ "t" command uses the DOS console driver for terminal
  3970.      emulation.  Standard ANSI.SYS is limited to a small subset of ANSI
  3971.      escape sequences; NANSI.SYS, FANSI-Console and other replacement console
  3972.      drivers provide faster screen updates and better ANSI terminal
  3973.      emulation.
  3974.  
  3975.      DESQview users: make sure "Separate Shift State" is set to "N".  (Tnx to
  3976.      Tim Trott for this info.)
  3977.  
  3978.      Sep 18 1994: Supports the Startech ST16C650 UART with 32 byte FIFOs and
  3979.      on chip hardware flow control support.  This chip is identified as type
  3980.      3.
  3981.  
  3982.      July 17 1994: GSZ and DSZ now accept extended receiver defined character
  3983.      escaping requests which can specify the all ones character FF to be
  3984.      escaped.
  3985.  
  3986.      April 26 1994: The ZMODEM k, K and J numeric parameters have been added
  3987.      to help on machines with old style UARTS encountering LSR 02 serial inut
  3988.      errors.
  3989.  
  3990.      Feb 25 1994: The Windows multitasking added in the Jan 27 version has
  3991.      been modified; it was overly generous.  The subchapter on Windows
  3992.      operation has been changed.
  3993.  
  3994.      Feb 02 1994: Fixed anomalies with YMODEM-g and time display.  Hardware
  3995.      support was revised to accommodate a Hayes ESP board incompatibility
  3996.      with the 16550 spec.
  3997.  
  3998.      Jan 27 1994:  Added the "G" command to send an XON character to the
  3999.      modem.  This is useful when calling dsz from MSKermit as MSKermit sends
  4000.      an XOFF character to the modem.  Multitasking on OS/2 and Windows has
  4001.      been improved.  Handshake slow is more aggressive in flushing disk
  4002.      buffers.
  4003.  
  4004.      Nov 29 1993:  Rebuilt to correct zipfile authentication problems.
  4005.      Detection of 7-bit and nontransparent paths improved.
  4006.  
  4007.      Nov 27 1993:  Serial I/O has been tuned for more efficient operation
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.      Chapter 21 Pg 66      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4014.  
  4015.  
  4016.      with internal modems using firmware driven virtual UARTs.
  4017.  
  4018.      May 29 1993: The portx command now works with IRQ's up to 15, and,
  4019.      optionally, nonstandard baudrate clocks.
  4020.      EXAMPLE: dsz portx 3e8,15 rz -m
  4021.  
  4022.      Newer UART chips can use raw bit rate sources higher than the standard
  4023.      1.8432 MHz.  Some 386 and 486 machines support MobyBaud(TM) operation
  4024.      above 115200 bps.
  4025.  
  4026.      To support a nonstandard bit rate source, multiply 5760 by the new raw
  4027.      bit rate source frequency in MHz divided by 1.84320.
  4028.      EXAMPLE: dsz portx 3e8,15,57600   sp 38400 rz -m
  4029.      supports the 18.432 MHz clock option on the Boffin Electronics "WinSport
  4030.      II" 2 port serial board.
  4031.  
  4032.      May 3 1993: SlugBait should now work for XMODEM and YMODEM.  Some
  4033.      problems with file transfers over 7-bit paths were fixed (DSZ.EXE,
  4034.      GSZ.EXE).
  4035.  
  4036.      Nov 9 1992: Unwanted registration info message removed from registered
  4037.      copies.  Enhancements to accommodate non standard XMODEM programs.
  4038.      Corrected spurious automatic recognition of hardware handshake
  4039.      configuration.
  4040.  
  4041.      May 3 1992: Recompiled to correct bad file size/CRC values in DSZ.DOC
  4042.      and DSZNEW, pruned some unused code.  No functional changes from April
  4043.      27 vsn.
  4044.  
  4045.      April 27 1992: The GSZWINDOW environment variable can be set to 1, 2 or
  4046.      3 to leave the top 1, 2 or 3 lines unmolested.  DSZ.EXE is compiled on a
  4047.      newer compiler and now supports file sharing.
  4048.  
  4049.      Bogus/hacked/infected files with early 1992 revision dates have been
  4050.      reported.
  4051.  
  4052.      Dec 13 1991: DSZ and GSZ automatically support Doorway 2.2 without extra
  4053.      commands.
  4054.  
  4055.      The RZ.BAT and SZ.BAT files are supplied for convenience.  RZ.BAT allows
  4056.      calling programs that emit an "rz" command to automatically start DSZ
  4057.      from the DOS command prompt.  SZ.BAT is a convenient command interface
  4058.      that complements RZ.BAT.  You may modify SZ.BAT and RZ.BAT with your
  4059.      favorite options.
  4060.  
  4061.      The GSZ file transfer display now shows a distinct color at the
  4062.      locations where error retries occurred.  This gives a visual impression
  4063.      of the distribution of error retries.
  4064.  
  4065.      Oct 15 1991:  To accommodate other vendors' programs which do not
  4066.      provide a convenient way to control crash recovery, the "restrict"
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.      Chapter 21 Pg 67      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4073.  
  4074.  
  4075.      command security check is not performed if the destination file does not
  4076.      exist.
  4077.  
  4078.      Oct 8 1991: Some versions of putsnp were confused by a data pattern in
  4079.      the Oct 7 dsz.com, misplacing the installed serial number.  Oct 7 1991:
  4080.      The "t" (talk) command now accepts -h and -H to enable local echo.  Oct
  4081.      1 1991: Fixed an interaction between FIFO uarts and YMODEM-g termination
  4082.      after all files have been sent.  Fixed problem of some options being
  4083.      ignored on XMODEM and YMODEM downloads.  Fixed graphics display problem
  4084.      involving more than 40 MB of files.  Sep 4 1991: GCOLORS now saves the
  4085.      color scheme in a separate file GCOLORS.T.  Many small improvements in
  4086.      the GSZ file xfer display.  GCOLORS adds a "m" menu choice to remove
  4087.      color from the color scheme.
  4088.  
  4089.      A conflict between crash recovery and user specified short packets has
  4090.      been corrected.
  4091.  
  4092.      DSZ.EXE and GSZ now accept the "c" option to force incoming files to use
  4093.      a changed file name when a file with the same name exists.  DSZ.COM does
  4094.      not support this.  The receiving program must support this new ZMODEM
  4095.      option or file disposition will be undefined.
  4096.  
  4097.      Aug 7 1991: Serial I/O modifications have solved a Wedge-O-Matic(R)
  4098.      problem with one hardware configuration (antique 2400 bps internal
  4099.      modem).  Hopefully this will solve similar non-replicatable problems for
  4100.      other users.
  4101.  
  4102.      A number of display fixes/enhancements to GSZ, including the addition of
  4103.      the GSZWINDOW environment variable enabling BBS sysops to protect BBS
  4104.      status lines at the bottom of the screen.
  4105.  
  4106.  
  4107.      July 29 1991: Corrections to gcolors registration function.
  4108.  
  4109.      July 28 1991: Some changes to GSZ and CGOLORS to improve human factors.
  4110.  
  4111.      "GCOLORS -q" disables the flashing reminder of which field is being
  4112.      modified.  This was added to help users with certain visual impairments.
  4113.  
  4114.      A few users have reported hung transfers wither certain hardware and/or
  4115.      software configurations.  We have not been able to replicate the
  4116.      problem, but have added code that recovers from lost interrupts.
  4117.  
  4118.      July 21 1991: Preview release of GSZ!!
  4119.  
  4120.  
  4121.      July 3 1991: Spurious "Invalid Download Directory" message has been
  4122.      removed.  More hacks to accommodate AT&T's mutant "ymodemb" protocol.
  4123.      AT&T may be the right choice, but their "ymodemb" is not the right
  4124.      protocol.
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.      Chapter 21 Pg 68      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4132.  
  4133.  
  4134.      June 13 1991: DSZLOG entries made by the 6/10 DSZ had no carriage
  4135.      returns.  Please check the "pxN" and "z pxN" command descriptions for
  4136.      important clarifications.
  4137.  
  4138.      June 10 1991: A problem with sending with flow control has been fixed.
  4139.      Intelligent Crash Recovery(TM) has been enhanced to prevent timeouts
  4140.      when computers with different CPU speeds are used.
  4141.  
  4142.      May 31 1991:  The "sb" command has been hacked to accommodate an AT&T
  4143.      nonstandard "ymodemb" protocol.
  4144.  
  4145.      The handling of hardware flow control has been hacked to prevent flow
  4146.      control timeouts caused by TSR programs that poll the UART status
  4147.      registers.
  4148.  
  4149.      The size of the input buffer has been increased.
  4150.  
  4151.      The "V" numeric parameter has been added to DSZ.COM to allow direct
  4152.      video output in some instances.
  4153.  
  4154.      April 29 1991: The "t" command no longer ignores options set with DSZOPT
  4155.      and/or as flags to the "t" command.
  4156.  
  4157.      April 16 1991: Operation of "handshake slow" has been enhanced when
  4158.      receiving with ZMODEM CRC-32 and MobyTurbo(TM).  Users who had
  4159.      previously found "handshake slow" unable to control disk related "Line
  4160.      Status Register 02" overrun errors should find the new "handshake slow"
  4161.      more effective on ZMODEM CRC-32 and MobyTurbo downloads.
  4162.  
  4163.      DSZ.COM and DSZ.EXE now announce themselves as DSZ.COM and DSZ.EXE.
  4164.      DSZ.DOC has more discussion of differences between .COM and .EXE flavor.
  4165.      See the FILES chapter for expanded discussion of DSZ.COM vs DSZ.EXE.
  4166.  
  4167.      April 4 1991:  DSZ now supports 115200 bps on suitable hardware.
  4168.      DSZ.EXE throughputs of 113000 bps have been achieved with modest
  4169.      trickery.  "Your mileage may vary."
  4170.  
  4171.      The -I option has been added to the sz command.  The -I option causes
  4172.      new versions (Mar 29 1991 or later) of VMS rz to store files with the
  4173.      VMS Variable length (mrs=510) binary format.  Adding this record format
  4174.      should prevent VMS Kermit servers from corrupting file contents.
  4175.  
  4176.      Feb 28 1991:  The instructions for adding DSZ to ProComm Plus have been
  4177.      updated to include PCP version 2.  Datastorm has not licensed ZMODEM-
  4178.      90(TM) despite allegations that DSZ is now "built in" to ProComm Plus
  4179.      version 2.
  4180.  
  4181.      The F command was added to leave the 16550A FIFO enabled on exit.  The
  4182.      speed command now updates the effective baudrate used for time
  4183.      estimates.
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.      Chapter 21 Pg 69      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4191.  
  4192.  
  4193.      sz -e is more network friendly.  (If you don't know what sz -e does, you
  4194.      don't want to know - trust me.)
  4195.  
  4196.      Dec 16 1990:  Code changes to improve operation with the Intel
  4197.      SatisFAXtion modem/fax board.
  4198.  
  4199.      Nov 19 1990:  A number of small enhancements.
  4200.  
  4201.      The sz -i and -u options were added.  The -i option is useful sending
  4202.      files to VMS rz version 4.x, forcing VMS Stream_LF record format.  The
  4203.      -u option unlinks (deletes) a file after it is successfully sent with
  4204.      ZMODEM.
  4205.  
  4206.      SlugBait has been fixed.
  4207.  
  4208.      The Y numeric parameter (described above) has been added to allow FIFO
  4209.      hackers to do their thing.
  4210.  
  4211.      June 25 1990: When a ZMODEM block length is forced, the receiving DSZ
  4212.      writes the data to disk before acknowledging the block.  With DSZ.EXE
  4213.      and its maximum 16384 buffer size, you may be able to avoid overrun
  4214.      (Line Status Register 02) problems receiving to slow disk drives by
  4215.      using:
  4216.      DSZ pB16384 z pl16384 rz
  4217.  
  4218.      ZMODEM-90(TM) speeds up GEnie ZMODEM downloads; see DSZOPT.
  4219.  
  4220.      The "sz" command had an undocumented fallback to YMODEM, this has been
  4221.      removed for reliability reasons.
  4222.  
  4223.      The SlugBait (-s) option now causes DSZ to return success (0 exit code)
  4224.      if at least one file is transferred.
  4225.  
  4226.      April 11 1990: Enhancements for more efficient multitasking under
  4227.      DESQview and DESQview 386.  Code which prevented IRQ conflicts between
  4228.      COM1/COM3 and COM2/COM4 has been removed to allow use of COM7 and COM8
  4229.      without interference from DSZ running on COM1 or COM2..
  4230.  
  4231.      ZIP replaces ARC as the standard download distribution format on new
  4232.      files.
  4233.  
  4234.      March 21 1990: DSZ now sends the CANCEL sequence if it runs out of disk
  4235.      space while receiving a file with ZMODEM.
  4236.  
  4237.      DSZ now defaults to "handshake both" if the clear to send signal is high
  4238.      when DSZ selects the comm port regardless of the initial "baud rate".
  4239.  
  4240.      The P parameter can be set to -1 to disable the FIFO on the Western
  4241.      Digital WD16550 chip.  The WD16550 FIFO has been observed to lose
  4242.      characters when transmitting at slow baud rates.  A more elegant
  4243.      software solution to this hardware problem may be discovered in the
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.      Chapter 21 Pg 70      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4250.  
  4251.  
  4252.      future.
  4253.  
  4254.      Feb 25 1990: Doco change only. The "R" numeric parameter or the
  4255.      "restrict" command may be used to force partially received files to be
  4256.      deleted.  These features have been in DSZ for a long time, but never got
  4257.      into DSZ.DOC.
  4258.  
  4259.      Feb 18 1990: DSZPORT now accepts "portx" style arguments in addition to
  4260.      the traditional decimal number.  The -Wn option has been improved.
  4261.  
  4262.      Jan-28-1990: Doco improvements, especially to the "In Case of
  4263.      Difficulty" chapter.  BBS registration clarified for those that bother
  4264.      to read it.  Qmodem batch files fixed.  No change to the DSZ software.
  4265.  
  4266.      Jan-22-1990: ZMODEM-90(TM) extensions:
  4267.  
  4268.      Receiver specified window size: The -Wn option operates similarly to the
  4269.      -wn option.  The -Wn option is specified to the receiver, which sends
  4270.      this information to the sender.  Pro-YAM, ZCOMM and DSZ versions
  4271.      beginning with Jan 22 1990 support this.
  4272.  
  4273.      Specified extra escaped characters: The "zmtxesc" and "zmrxesc" allow
  4274.      extra characters to be escaped when sending (zmtxesc) or receiving
  4275.      (zmrxesc).  Zmtxesc is effective sending to any ZMODEM program.  The sz
  4276.      commands in Omen products after Jan 22 1990 except for DSZ.COM recognize
  4277.      incoming "zmrxesc" requests.  The zmrxesc and zmtxesc string parameters
  4278.      consist of one or more printing characters corresponding to the control
  4279.      characters to be escaped.  To escape NULL:  set zmrxesc "@"
  4280.  
  4281.      Since DSZ does not support string parameters, a -Q<string> option unique
  4282.      to DSZ performs the same function as zmrxesc and zmtxesc.  If the
  4283.      Q<string> option is used in DSZOPT, it must be last.  To escape NULL:
  4284.      DSZ sz -Q@ file.ext
  4285.  
  4286.      MobyTurbo(TM):
  4287.  
  4288.      MobyTurbo optimizes throughput on GIF, ZIP, ARC, and similar files
  4289.      without sacrificing ZMODEM's famous reliability on noisy lines.
  4290.      MobyTurbo works with standard modems, error correcting modems with
  4291.      hardware flow control, and over paths that support ZMODEM and do not
  4292.      "eat" or otherwise respond to control characters.  This includes all
  4293.      paths that support YMODEM-g (or would except for line noise).
  4294.  
  4295.      MobyTurbo can be used for downloads over PC Pursuit if software flow
  4296.      control is not turned on.
  4297.  
  4298.      Activate MobyTurbo with the -m option to one or more of: sz command, rz
  4299.      command, or DSZOPT environment variable.
  4300.  
  4301.      ZMODEM over 7 bit paths:  (Not supported in DSZ.COM)
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.      Chapter 21 Pg 71      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4309.  
  4310.  
  4311.      A pair of ZMODEM-90 programs with 7-bit support operating over a 7 bit
  4312.      path should detect that fact and switch to one of two 7-bit path
  4313.      compatible encodings.  For testing, this can be forced with a "-E"
  4314.      option.
  4315.  
  4316.      Default 7-bit mode is RLE compression and 8th bit quoting similar to
  4317.      Kermit but more efficient because not so many control characters are
  4318.      quoted.  Use this default for text files.  Rubout and all control
  4319.      characters can be escaped with the -e option.  Individual control
  4320.      characters can be escaped with "zmtxesc" and "zmrxesc".
  4321.  
  4322.      Pack-7 instead of quoting is activated with the -P option.  (-P has no
  4323.      effect on 8 bit paths.) Pack-7 packs 4 bytes into 5 printing characters.
  4324.      This is more efficient than quoting for files where 25% more 8th bits
  4325.      appear than the number of characters saved by RLE compression.  (This
  4326.      statement applies to GIF, ARC, ZOO, and ZIP files.  It may or may not
  4327.      apply to other binary file formats, depending on the data.) Pack-7 will
  4328.      match or beat standard Kermit on ZIP files, even when Kermit has use of
  4329.      all 8 bits.
  4330.  
  4331.      SUPK412.ZIP 75136 bytes sent at 2400 bps direct connect from an
  4332.      Everex 1800 AT clone 8mHz/0ws to an 18 mHz Intel 386 motherboard.
  4333.  
  4334.      8-Bit line
  4335.      cps     Protocol/command
  4336.      156     MS Kermit 3.00 to MS Kermit 3.00  (defaults)
  4337.      182     MS Kermit 3.00 to MS Kermit 3.00  (windows=2 length=2000)
  4338.      184     MS Kermit 3.00 to Pro-YAM 17.51 (windows=2 length=2000)
  4339.      231     Pro-YAM 17.51 ZMODEM (defaults)
  4340.      237     Pro-YAM 17.51 ZMODEM-90(TM) MobyTurbo(TM) (sz -m)
  4341.  
  4342.      7-Bit line
  4343.      cps     Protocol/command
  4344.      156     MS Kermit 3.00 to MS Kermit 3.00  (windows=4 length=2000)
  4345.      190     Pro-YAM 17.51 ZMODEM-90 PACK-7 (sz -EP)
  4346.  
  4347.      Kermit transfers used 8 bit CRC, ZMODEM used 32 bit CRC.
  4348.  
  4349.  
  4350.      ************************************************************************
  4351.      ************************************************************************
  4352.  
  4353.      WHAT TO LOOK FOR:
  4354.  
  4355.      Performance     difference     with     MobyTurbo,     possible     side
  4356.      effects/incompatibilities.   MobyTurbo  logic  tests  for  software flow
  4357.      control incompatibilities: when does this test fail?
  4358.  
  4359.      Automatic detection of 7-bit paths.  Spurious detection of  7-bit  paths
  4360.      and failure to detect 7-bit paths.  (DSZ.EXE only)
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.      Chapter 21 Pg 72      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4368.  
  4369.  
  4370.      12-13-89  The Virus check was removed because of user confusion and slow
  4371.      startup under certain conditions.  Code has been added to prevent and/or
  4372.      recover from "line status register 18" errors.
  4373.  
  4374.      10-28-89 A T may be appended to DSZOPT or "DSZ t  -T"  may  be  used  to
  4375.      force  DSZ  to  exit  after  it has recognized a ZMODEM AutoDownload(TM)
  4376.      request.
  4377.  
  4378.      10-24-89  BBS registered copies (serial  numbers  8000-8999  and  20000-
  4379.      23999) are now fully featured.
  4380.  
  4381.      The BBS registration form has been  modified.   Please  read  this  form
  4382.      carefully  before  applying  a  BBS  serial  number.   Use of BBS serial
  4383.      numbers (4000, 20000 series) acknowledges acceptance of this contract.
  4384.  
  4385.      The IMP/KMD compatibility file length information in the  YMODEM  header
  4386.      generated by the sb command now uses the correct byte ordering.  Changes
  4387.      to the XMODEM/YMODEM sz/sb commands were made  to  accommodate  programs
  4388.      that ise CK or CKL.  (As predicted in 1985, networks sometimes interfere
  4389.      with these sequences.)
  4390.  
  4391.      Files passed over because of creation errors at the  receiving  end  are
  4392.      now  counted  by the "sz" command as errors.  The receiving program must
  4393.      be a 9/89 or later version for this to be effective.
  4394.  
  4395.      The specified directory form of the rz and rb commands has been  enanced
  4396.      to accommodate certain forms of erroneous syntax.
  4397.  
  4398.      6-19-89 A documentation error (concerning DSZPORT) was corrected in  the
  4399.      DOC file.
  4400.  
  4401.      5-25-89  Corrects a protocol negotiation problem encountered when the rz
  4402.      or sz -e option is used.
  4403.  
  4404.      Host programs can now specify an alternate CANCEL sequence (not used for
  4405.      DOS and Unix).
  4406.  
  4407.      The ZMODEM "Slow Send" mode inserts a brief pause after  each  subpacket
  4408.      when  invoked with the -F option, or automatically when the "sz" command
  4409.      detects failing flow control.  The zmodem F numeric  parameter  (default
  4410.      1) sets the pause in tenths of seconds.
  4411.  
  4412.      4-24-89 The -rr option has been improved.  Long file compares  are  done
  4413.      in  two  stages  to  save  time  when  the  first portions do not match.
  4414.      Diagnostic code and undocumented commands have been removed to  decrease
  4415.      the program size.
  4416.  
  4417.      The 4-18 version introduces ZMODEM variable length headers of up  to  16
  4418.      bytes  information  field instead of the previous fixed 4.  Selection of
  4419.      variable length header capability is automatic and downward  compatible.
  4420.      Variable   length   headers   allow   future   extensions   to  ZMODEM's
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.      Chapter 21 Pg 73      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4427.  
  4428.  
  4429.      capabilities.
  4430.  
  4431.      ZMODEM Crash Recovery now understands the  -rr  option  to  compare  the
  4432.      CRC-32   of  the  assumed  common  file  segment  before  continuing  an
  4433.      incomplete file transfer.  The "zmodem R" numeric parameter may  be  set
  4434.      to limit the number of bytes in the files that are compared; the default
  4435.      R value of 0 allows all of the file to be compared, an  R  value  up  to
  4436.      32000  (up  to 2 billion on 32 bit flavors) limits the comparison to the
  4437.      first R bytes of the two files.  The ZMODEM -rr option is  supported  by
  4438.      Omen Tech versions April 18 1989 and later.
  4439.  
  4440.      When ZMODEM Crash Recovery detects incompatible source  and  destination
  4441.      file  contents,  the  destination  file  is now truncated to zero length
  4442.      before proceeding  with  the  transfer.   Crash  Recovery  requires  the
  4443.      destination file to be no longer than the source file.
  4444.  
  4445.      Error reporting on unregistered copies has been enhanced  to  point  the
  4446.      user to solutions described in the relevant chapters in DSZ.DOC.
  4447.  
  4448.      3-18-89 In order to work around a bug in the  new  TCOMM  bbs,  DSZ  now
  4449.      defaults  to  "handshake  on"  if the speed is greater than 2400 and the
  4450.      clear to send signal is high when DSZ selects the comm port.
  4451.  
  4452.      The "o" command has been added to disconnect the modem after a  terminal
  4453.      session:  "DSZ  t  o" disconnects the modem when the terminal session is
  4454.      completed.
  4455.  
  4456.      The "P" (capital P) numeric parameter (q.v.) has been added  to  display
  4457.      and control the UART fifo on some clone chips.
  4458.  
  4459.      BBS registrations postmarked after Feb 28 1989 must be accompanied by  a
  4460.      paid  DSZ  registration.  The free program expired Feb 28 1989.  Outside
  4461.      help has been hired to process and verify  applications  received  under
  4462.      that program.
  4463.  
  4464.      2-23-89 The term function now sends BREAK in response to the ALT-B  key.
  4465.      Handling  of  the  Ctrl-Break  vector  has  been  changed so an untimely
  4466.      keyboarded Ctrl-C or Ctrl-Break will not hang DOS.
  4467.  
  4468.      2-15-89  DIRRX is enabled for BBS registrations (8xxx  numbers).   Logic
  4469.      has  been  added  to  simulate  transmit  interrupts  on chips that have
  4470.      problems in this area.  The "A" command does not  require  registration.
  4471.      An  interaction between ONAME= or PREFIX= and the file count display has
  4472.      been removed.  Time/date conversion routines have been enhanced to  deal
  4473.      with  files with missing dates.  The "v" command has been added to allow
  4474.      bbs programs to interrogate DSZ's serial number.
  4475.  
  4476.      2-06-89 A spurious error message at the completion of  YMODEM  downloads
  4477.      with  a  download  directory  specified  on  the  command  line has been
  4478.      eliminated.
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.      Chapter 21 Pg 74      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4486.  
  4487.  
  4488.      2-05-89 DSZ now returns a non 0 status unless at least one file has been
  4489.      transferred.    An   inappropriate   pathname/disk  specifier  check  on
  4490.      specified download directories has been removed.
  4491.  
  4492.      Previous versions:
  4493.  
  4494.      SlugBait logic has been simplified, reporting any failed  file  transfer
  4495.      where any of the last 1K of the file was sent with Q status.
  4496.  
  4497.      Introduced ZMODEM RLE compression with the -Z option.   (registered  DSZ
  4498.      copies  also  accept "Z" in the DSZOPT environment variable.) ZMODEM RLE
  4499.      compression packs runs of the same character in two or  three  character
  4500.      sequences.    Compression  is  useful  for  screen  dumps,  uncompressed
  4501.      workspaces, compiler listings, and other  files  rich  with  strings  of
  4502.      repeated  characters,  but  not  .GIF,  .ARC,  .ZOO and other compressed
  4503.      files.  Compression percentages range  from  -1  per  cent  for  already
  4504.      compressed  files  to  more  than  1000  per cent (10x speedup!) for the
  4505.      Personal Computing text file benchmark(!).   When  sending  to  programs
  4506.      that  do  not support ZMODEM compression, the -Z option is ignored.  The
  4507.      -Z option is effective when specified to the sending program only.
  4508.  
  4509.      "Handshake slow" has been added to disable the RTS signal to  the  modem
  4510.      while writing to disk, even if the interrupt buffer is not chock full of
  4511.      bytes.  This should help systems with  excessive  interrupt  latency  on
  4512.      disk writes.
  4513.  
  4514.      Setting the v (verbose) parameter to  1  or  greater  causes  serialized
  4515.      copies to ring the bell when a transfer is done.
  4516.  
  4517.      DSZ.DOC has been extensively rewritten and  reorganized.   DSZ  supports
  4518.      the  advanced  buffering of the National NS16550AN, NS16550AFN and Intel
  4519.      82510 serial interface devices.   Please  refer  to  the  subchapter  on
  4520.      "Brain Damaged UARTs".
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.      Chapter 22 Pg 75      DSZ Reference Rev Sep-18-94        Typeset 9-20-94
  4545.  
  4546.  
  4547.      22.  ACKNOWLEDGEMENTS
  4548.  
  4549.      32 bit CRC code courtesy Gary S. Brown.
  4550.  
  4551.      ZMODEM-90(TM), MobyTurbo(TM), The High Reliability Software(TM), Demand
  4552.      Upgrade(TM), TurboLearn Script Writer(TM), Cybernetic Data Recovery(TM),
  4553.      ZMODEM AutoDownload(TM), Intelligent Crash Recovery(TM), Error
  4554.      Containment(TM), Full Time Capture(TM), True YMODEM(TM),
  4555.      OverThruster(TM), Password Guardian(TM), CryptoScript(TM), and
  4556.      TurboDial(TM) are Omen Technology trademarks.
  4557.  
  4558.      PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro
  4559.      Oregon.
  4560.  
  4561.      True YMODEM(TM) is an Omen Technology Trademark signifying YMODEM
  4562.      protocol support that meets the full YMODEM specification.
  4563.  
  4564.      DSZ and this documentation are Copyright 1991 by Omen Technology Inc,
  4565.      all rights reserved.  DSZ is not and never has been Public Domain.
  4566.      Every version of DSZ has included a Copyright Notice and a prohibition
  4567.      against sale or modification.  This prohibition applies to any theft of
  4568.      the intellectual property and trade secrets contained in DSZ by
  4569.      decompilation, disassembly, or any other form of reverse engineering
  4570.      including but not limited to profiling, tracing, data analysis, or
  4571.      monitoring the operation of DSZ.
  4572.  
  4573.      Omen Technology copyright applies to its expression of the encoding and
  4574.      compression ideas expressed as code and byte streams used in the
  4575.      ZMODEM-90 enhancements.
  4576.  
  4577.      DSZ is not and never has been Copy Protected.  "DSZ unprotect" files
  4578.      have no function whatsoever except to aid and encourage the theft of
  4579.      Omen Technology's Intellectual Property.
  4580.  
  4581.                            Omen Technology Incorporated
  4582.                           The High Reliability Software
  4583.  
  4584.                        17505-V Northwest Sauvie Island Road
  4585.                               Portland Oregon 97231
  4586.                      Modem: 503-621-3746 Speed 1200,2400,V.32
  4587.                                 FAX: 503-621-3735
  4588.                  CompuServe:70007,2304  GEnie:CAF   BIX:cforsberg
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.