home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / k9x85_3.zip / YMODM-G.ZIP / DSZ.DOC < prev    next >
Text File  |  1988-01-10  |  41KB  |  991 lines
  1.  
  2.  
  3.  
  4.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  5.  
  6.  
  7.  
  8.      NAME
  9.           dsz - ZMODEM, True YMODEM(TM), XMODEM file transfer
  10.           subprogram
  11.  
  12.      SYNOPSIS
  13.           dsz [CON] [port N] [speed S] [handshake XX] [D] [d] command
  14.  
  15.      DESCRIPTION
  16.           Dsz is a "protocol driver" that uses the ZMODEM, True
  17.           YMODEM(TM), or XMODEM protocol to transfer files over a
  18.           serial port with a variety of programs.
  19.  
  20.           Non registered users are granted a license to use dsz for a
  21.           limited evaluation period.  Otherwise, use of dsz requires
  22.           registering the copy.  Registration enables some advanced
  23.           features.
  24.  
  25.           If you received this copy of DSZ with another progam, even
  26.           if your copy of the other program is registered, this copy
  27.           of DSZ has not been registered.  Please refer to the
  28.           licensing information below, and support the continued
  29.           development of high quality shareware.
  30.  
  31.           ZMODEM Transfers feature 32 bit CRC, crash recovery, and
  32.           advanced file management.
  33.  
  34.           When calling bulletin boards to download files with ZMODEM
  35.           or True YMODEM(TM), you can avoid the bother of starting DSZ
  36.           for each transfer by calling dsz first, before asking the
  37.           BBS for the download (dsz t).  The "t" command allows you to
  38.           keyboard the file request to the BBS.  DSZ's ZMODEM
  39.           AutoDownload then receives the file automatically, without
  40.           any wasted keystrokes or delay.  Try it, you'll like it!
  41.           (The "t" command is described below.)
  42.  
  43.           True YMODEM(TM) transfers preserve exact file length and
  44.           modification time.
  45.  
  46.           Dsz supports XMODEM-1k (XMODEM with 1024 byte blocks,
  47.           sometimes mislabeled YMODEM) and CRC-16 with the sx -k and
  48.           rc commands.
  49.  
  50.           Dsz is derived from Omen Technology's Professional-YAM
  51.           communications software, (also published by POLYTRON Corp of
  52.           Hillsboro Oregon as PowerCom(TM)), and supports a subset of
  53.           Pro-YAM's file transfer related commands.  This
  54.           documentation makes extensive references to contemporary
  55.           editions of the ZCOMM or Pro-YAM manual, and is incomplete
  56.           without it.
  57.  
  58.           Dsz is designed to be called from a communications bulletin
  59.           board program.  Dsz may also be called from other
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 1/10/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  71.  
  72.  
  73.  
  74.           communications programs, but the combination lacks much of
  75.           the power of a communications program with integrated
  76.           ZMODEM.
  77.  
  78.           Dsz uses its own modem I/O.  The original interrupt vector,
  79.           UART parity, interrupt configuration, and 8259 interrupt
  80.           mask are restored on exit.
  81.  
  82.           Dsz uses DOS standard output (stdout) for messages, it does
  83.           not write directly to the screen.  Dsz expects its standard
  84.           output to point to the console, a logging file, or NUL, not
  85.           the modem port.  If necessary, dsz's standard output may be
  86.           redirected to the console device with the CON command.  If
  87.           dsz's standard output has been redirected to the modem (as
  88.           with ProComm's Host mode DOS shell), failure to use the CON
  89.           command may lock up the computer.
  90.  
  91.           Dsz exits with 0 status for successful transfers, or the
  92.           value of the Q parameter (default 1) if a file transfer
  93.           failed.  Some languages do not return this information to
  94.           the calling program.  A batch file that calls dsz directly
  95.           may be used to detect the dsz exit status, or dsz's log file
  96.           entries may be examined.
  97.  
  98.      ENVIRONMENT VARIABLES
  99.           DSZLOG
  100.                log file to receive entries for files sent and
  101.                received.  (Default null).  Sample entries:
  102.  
  103.            Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM
  104.                1177
  105.            Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP
  106.                1177
  107.  
  108.                Transfer times are based on the DOS time of day clock
  109.                and have one second jitter.  As with all protocol
  110.                throughput reports generated by Omen Technology
  111.                programs (and contrary to the false claims of some
  112.                critics), dsz's throughput figures for ZMODEM, Kermit,
  113.                and True YMODEM(TM) transfers do not take "credit" for
  114.                pathname and/or protocol overhead characters.  Dsz's
  115.                throughput reports do not include the time required to
  116.                send the pathname.  This understates the true time
  117.                required to transfer files, but the time required to
  118.                send the pathname often depends on the alacrity of the
  119.                operator, and thus does not always reflect the
  120.                performance of the protocol itself.
  121.  
  122.                Transfers measuring less than one second are reported
  123.                as having 9999 characters per second throughput.
  124.  
  125.                The unlabeled numeric field after the error (retry)
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 1/10/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  137.  
  138.  
  139.  
  140.                count is the number of flow control stoppages
  141.                encountered sending the file.  This number gives an
  142.                indication of flow control restrictions (overloaded
  143.                networks, etc.) encountered during the transfer.
  144.  
  145.                The last numeric field before the file name is the
  146.                block or subpacket length used for the last block in
  147.                the file.
  148.  
  149.                The last field is the serial number of the other
  150.                program, or -1 if this information is not available.
  151.  
  152.                The code letter indicates the type of transfer, Z
  153.                (ZMODEM), S (X/YMODEM), R (X/YMODEM), E (error), or L
  154.                (transfer terminated by loss of data carrier).
  155.           DSZOPT
  156.                String containing default options for DSZ file
  157.                transfers.  (Registered copies only) An 8n may be
  158.                appended to the string to make BBS (ANSI) graphics the
  159.                default for dsz's t command.  The ability to preset
  160.                these options is especially helpful with dsz's t
  161.                command.  EXAMPLE:
  162.                C>set DSZOPT=r
  163.                Enables dsz's intelligent Crash Recovery as a default.
  164.  
  165.                Let's say you wish ZMODEM crash recovery, and BBS
  166.                "graphics" for the term function:
  167.                C>set DSZOPT=r8g
  168.  
  169.                WARNING: Do NOT include "ena" in the string.
  170.           MAXBYTES
  171.                Maximum number of bytes allowed for transfer.  If this
  172.                number is exceeded, dsz skips the offending files
  173.                (ZMODEM) or aborts remaining files in the batch
  174.                (YMODEM).
  175.           DSZPORT
  176.                Default communications port override, default 1.
  177.                EXAMPLE:
  178.                C>set DSZPORT=2
  179.           ZONE sets the z numeric parameter to the number of minutes
  180.                the current local time lags GMT time.  PDT or MST
  181.                corresponds to 420.  (Registered copies only) EXAMPLE:
  182.                C>set ZONE=420
  183.  
  184.      COMMANDS
  185.           Dsz commands are an improper subset of Pro-
  186.           YAM/PowerCom/ZCOMM commands.  Except as noted, all commands
  187.           must be in lower case, are exectued left to right, and must
  188.           be entered in the order shown at the beginning of this
  189.           document.
  190.  
  191.           Unlike ZCOMM, PowerCom, and Pro-YAM, dsz does not support
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 1/10/88)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  203.  
  204.  
  205.  
  206.           ZMODEM AutoDownload with ZMODEM security challenge.
  207.           (AutoDownload is a pleasant user interface that recognizes
  208.           the start of a file download and automatically starts the
  209.           correct file transfer protocol. Please refer to the
  210.           ZCOMM/PowerCom/Pro-YAM user manual for details on this
  211.           powerful and convenient feature.) Unregistered copies of dsz
  212.           do not support OverThruster(TM).  Dsz does not support
  213.           Kermit, Kermit AutoDownload, Super Kermit, B Protocol, the
  214.           traditional XMODEM variants MODEM7 batch, Telink, WXMODEM,
  215.           and Clink/SEAlink supported by Pro-YAM/PowerCom/ZCOMM.
  216.  
  217.           Interrupt keys:
  218.  
  219.           Ctrl-Break
  220.                Terminates the transfer in progress.
  221.           ALT-N
  222.                Abruptly terminates (NUKES) the transfer in progress.
  223.  
  224.  
  225.           When used, the CON, port, speed, handshake, and d commands
  226.           must be given in the order shown.
  227.  
  228.           CON  Redirect message output to the DOS "CON" (console)
  229.                device, overriding any previous redirections.
  230.           handshake XX
  231.                Enable one of several choices of hardware handshake.
  232.                (The default is XOFF/XON software handshake).  This
  233.                command is documented in the ZCOMM or Pro-YAM manual.
  234.           port N
  235.                select port N (n = 1,2,3,4 ... 8) Default is port 1
  236.                (COM1) or read from the DSZPORT dos environment
  237.                variable.  In multitasking operation, accessing a port
  238.                used by another running program will hang the machine.
  239.                EXAMPLE: to use COM2:
  240.                dsz port 2 rz
  241.           speed S
  242.                Set the specified speed.  This command is rarely needed
  243.                because dsk reads the port's current speed by default.
  244.                Please refer to to the FLOW CONTROL, MAIN COMMANDS and
  245.                SOFTWARE COEXISTENCE chapters in the ZCOMM or Pro-YAM
  246.                manual for important information about the speed
  247.                command.
  248.           D    Diaables the modem (drops Data Terminal Ready, DTR) if
  249.                carrier is lost.  This may be used to prevent spurious
  250.                events from interfering with a bulletin board's
  251.                recovery from carrier loss.
  252.           d    Disables carrier dropout monitoring, for modems that do
  253.                not properly drive the "Data Carrier Detect" input on
  254.                the PC.
  255.           LARG Convert ARG to lower case, then parse arg.
  256.           pxN  Set a numeric parameter x to N.  These parameters are a
  257.                subset of the Pro-YAM or ZCOMM numeric parameters, and
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 1/10/88)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  269.  
  270.  
  271.  
  272.                are listed below.  They assume their defaults each time
  273.                dsz is called.  Without an argument, p displays the
  274.                numeric parameters and their values.
  275.           z pxN
  276.                Set zmodem numeric parameter x to N.  These parameters
  277.                correspond to the Pro-YAM or ZCOMM "zmodem" parameters
  278.                and rarely need changing.  These parameters assume
  279.                their defaults each time dsz is called.  Without an
  280.                argument, z p displays the zmodem numeric parameters
  281.                and their values.
  282.           restrict
  283.                Restrict pathnames to the current disk and directory
  284.                tree, and disallows overwriting of existing files.
  285.                When dsz is restricted, it will refuse to transfer
  286.                files containing the string autoexec.bat and
  287.                command.com in either case.  This provides some defense
  288.                from malicious uploaded files.
  289.           t    [-8g] Talk with ZMODEM AutoDownload.  The optional -8g
  290.                (available on registered copies only) allows "BBS
  291.                (ANSI) graphics".  A small subset of ZCOMM/Pro-YAM term
  292.                function subcommands are recognized.  Keyboard F1 or
  293.                ALT-X to exit.  F3 receives file(s) with True YMODEMTm,
  294.                ALT-P toggles parity between the 8n default and 8g
  295.                (enables ANSI "graphics").  ALT-H toggles two local
  296.                echo ("Half Duplex") modes; the second displays a
  297.                newline on Enter.  Keyboarded ASCII characters are sent
  298.                to the modem.  Modem characters print on the screen.  A
  299.                device driver such as ANSI.SYS may be used to recognize
  300.                escape sequences.  ZMODEM AutoDownload detects the
  301.                start of a ZMODEM file download and accepts the file(s)
  302.                without operator intervention.
  303.           sz   [-abefnprtY+y] [-w[N]] [PREFIX=p | ONAME=n] file
  304.                ...(ZMODEM)
  305.           sb   [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM)
  306.           sb -k
  307.                [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k)
  308.           sx   [-t] file1                    (XMODEM or XMODEM/CRC)
  309.           sx -k
  310.                [-t] file1                    (XMODEM-1k)
  311.           rz   [-abenprt+Yy] [dir] [file ...]          (ZMODEM)
  312.           rb   [-abt+y] [dir] [file ...]     (YMODEM)
  313.           rb -g
  314.                [-abt+y] [dir] [file ...]     (YMODEM-g)
  315.           rc   [-abt+y] file1                (XMODEM/CRC)
  316.           ro   [-abt+y] file1                (XMODEM OverThruster)
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 1/10/88)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  335.  
  336.  
  337.  
  338.           rx   [-abt+y] file1                (XMODEM)
  339.  
  340.      PARAMETERS
  341.           Dsz uses the following main numeric parameters, settable
  342.           with the pxN command.  EXAMPLE:
  343.           dsz pB4096
  344.  
  345.           In addition, dsz uses the Pro-YAM/ZCOMM zmodem numeric
  346.           parameters described in the Pro-YAM/ZCOMM manual.
  347.  
  348.           B    Set the size of buffer used for disk reads and writes.
  349.                The default is 1024, 8192 maximum.  A larger value may
  350.                give better results when sending files to or from from
  351.                sluggish floppy disk systems.  Too large a value will
  352.                exhaust memory or induce receiver timeouts.  This
  353.                parameter is supported on versions compiled with
  354.                TurboC.
  355.           Q    Error code returned to DOS (default 1).  (Success
  356.                returns 0.) Some programs toss cookies when confronted
  357.                with certain exit codes.
  358.           O    Controls OverThruster(TM) operation with XMODEM,
  359.                XMODEM-1k, and YMODEM downloads.  This parameter should
  360.                be set as follows:
  361.  
  362.                CompuServe XMODEM Negative numbers control the number
  363.                of bytes added to the window on XMODEM downloads from
  364.                the CompuServe Information Service.  Larger numbers
  365.                increase throughput, but cause improperly interfaced
  366.                MNP modems on CIS nodes to drop characters under
  367.                stress, disrupting the file transfer.  EXAMPLE:
  368.                dsz pO-512 ro file1.ext
  369.  
  370.                Other XMODEM Positive numbers up to a system dependent
  371.                value less than the protocol block size increase
  372.                throughput.  Larger values induce timeouts and/or
  373.                retransmitted blocks.  The optimum value must be
  374.                determined by experiment.  60 usually give best results
  375.                with MNP modems at 2400 bps.  The optimum value varies
  376.                depending on the remote computer, modem(s), system
  377.                traffic, and the network node.  EXAMPLE:
  378.                dsz pO60 ro file1.ext
  379.           S    Timeout in seconds (default 15) waiting for restraint
  380.                release (XON and/or handshake).
  381.           W    Wait for Enter key before exiting after an error.
  382.                Useful when calling dsz from DESQview, allows the
  383.                window to close unless there is an error message that
  384.                should remain visible.
  385.           a    Calibrates certain protocol timeouts used with XMODEM
  386.                and YMODEM transfers (Cybernetic Data Recovery(TM)).
  387.                The a numeric parameter is automatically set to 2000
  388.                for a 4.77 mHz PC or XT, 4000 for a PS2/30, 6000 for an
  389.                8 mHz 1ws AT, and 12000 for a PS2/80.  If your computer
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 1/10/88)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  401.  
  402.  
  403.  
  404.                has a speedup card or otherwise runs unusually fast (or
  405.                slow!) for its type, you should set the a numeric
  406.                parameter to a value that reflects its speed.
  407.           v    Verbose level (debugging output) Negative values
  408.                inhibit some routine messages
  409.           z    Timezone in minutes behind GMT, used for ZMODEM and
  410.                True YMODEM file transfers to coordinate the actual
  411.                date of the file with computers in other time zones.
  412.                Effective on registered copies.  PDT or MST corresponds
  413.                to 420.  This may be preset with the ZONE DOS
  414.                environment variable.
  415.  
  416.      BACKGROUND OPERATION
  417.           Three DESQview description files are provided to demonstrate
  418.           background operation with modest (66 kb window) memory
  419.           requirements.  Dsz uses tight C/ASM code, table driven CRC
  420.           generators, and buffered receive and transmit for good
  421.           performance in the background without hogging CPU cycles.
  422.           On a QIC Labs PC-AT clone, dsz can download files in the
  423.           background (3 background clock ticks, 9 foreground clock
  424.           ticks) with a throughput better than 9600 bps.
  425.  
  426.           2S   Prompts for file name(s) and sends them with ZMODEM
  427.                protocol.
  428.           2T   Talks to the modem and allows manual YMODEM (F3) or
  429.                automatic ZMODEM downloads.
  430.           2A   Like 2T, but using Quarterdeck's dvansi.com memory
  431.                resident ANSI CRT device driver to process ANSI screen
  432.                codes.  DS.BAT is the batch file used by 2A.
  433.  
  434.                These files are written for a port 2 local connection
  435.                and \TMP directory, but may be modified to suit your
  436.                requirements using the DESQview CP command.  The W
  437.                numeric allows DESQview to close the window after dsz
  438.                finishes, providing a pleasant user interface.
  439.  
  440.                Operation at high speed (above 9600 bps) requires the
  441.                DESQview "Optimize communications" performance Advanced
  442.                Setup option.
  443.  
  444.                ***********************************************************
  445.                                        WARNING
  446.                When running dsz under a multi tasking system such as
  447.                DESQview, do not allow two programs to access the same
  448.                comm port at the same time.  At best, such actions will
  449.                disrupt communications.  At worst, your computer will
  450.                attempt to open a subspace channel to V'ger.
  451.                ***********************************************************
  452.  
  453.      FLOW CONTROL
  454.           Please refer to the Pro-YAM, PowerCom, or ZCOMM manual FLOW
  455.           CONTROL chapter for important information on flow control
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 1/10/88)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  467.  
  468.  
  469.  
  470.           considerations necessary for proper operation of ZMODEM and
  471.           other streaming protocols with buffered (error correcting)
  472.           modems and/or networks.
  473.  
  474.      EXAMPLES
  475.           dsz sz c:foo.* b:*.c          (send files)
  476.  
  477.           dsz sz -r yzmodem.arc         (CRASH RECOVERY: resume
  478.           interrupted transfer)
  479.  
  480.           dsz handshake both sz yzmodem.arc       (Hardware+Software
  481.           handshake)
  482.  
  483.           dsz sz -n *.*                 (send files that are newer or
  484.           rx has no copy)
  485.  
  486.           dsz sz -Yn *.*                (Only send files that are
  487.           newer than receiver's copy)
  488.                                         (Do not send files that do not
  489.           exist on receiver's disk)
  490.  
  491.           dsz rz C:/UPLOADS             (receive files to specified
  492.           directory)
  493.  
  494.           dsz port 2 speed 38400 restrict rz
  495.  
  496.           dsz rz  -y prog.arc           (ZMODEM, single file pathname
  497.           override)
  498.  
  499.           dsz z pr1 rx foo.dat          (XMODEM receive, remove file
  500.           if error)
  501.  
  502.           dsz pO60 ro foo.dat           (XMODEM/OverThruster receive,
  503.           GEnie MNP)
  504.  
  505.           DSZ LRC L-Y NEWPROG.ARC       (generate lower case "rc -y"
  506.           command)
  507.  
  508.           dsz pv2 sz foo >debug.dmp     (Debugging data dump)
  509.  
  510.      ERROR MESSAGES
  511.           The message Abnormal program termination is printed by the
  512.           TurboC startup routine if dsz is run in too small a memory
  513.           partition.  If you see this message, use a larger memory
  514.           partition for dsz or remove some memory resident programs.
  515.           This message may also appear if the calling program fails to
  516.           free memory before calling dsz.
  517.  
  518.           The message Unknown Machine Type XX, Assuming AT indicates a
  519.           ROM BIOS that does not follow the IBM specification for
  520.           identifying the machine type.  If your computer causes dsz
  521.           to display this message, you must set the a numeric
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 1/10/88)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  533.  
  534.  
  535.  
  536.           parameter described elsewhere in this document.
  537.  
  538.           A perplexing, cryptic message comes from the Microsoft C
  539.           Library: "Permission denied".  This may be caused by
  540.           attempts to modify a read only file or directory, or create
  541.           a file in a nonexistient directory.
  542.  
  543.           A furtive flashing appearance of "XOFF" or "FLOW" during
  544.           ZMODEM or YMODEM-g file sending signifies dsz is responding
  545.           to flow control restraint.  This is normal operation when
  546.           buffered modems or packet switched networks are used.
  547.           ZMODEM's robustness and reliability allow creative users to
  548.           transfer files over unusual multiple computer lash-ups,
  549.           causing modem data lights and computer status displays to
  550.           dance in unfamiliar rhythms.
  551.  
  552.           Other Dsz error messages are listed in the Pro-YAM manual.
  553.  
  554.      SEE ALSO
  555.           Consult the Professional-YAM, PowerCom, or ZCOMM manual
  556.           chapter "OPTIONS FOR FILE TRANSFERS" for option meanings.
  557.           The "FILE TRANSFER BASICS" chapter explains the relative
  558.           merits of XMODEM, YMODEM, ZMODEM, and other protocols and
  559.           gives tips on their use.  The "MAIN COMMANDS" chapter
  560.           describes the rb, rx, rc, rz, sb, and sz commands.  The
  561.           "MODEM INTERFACING" and "FLOW CONTROL" chapters contain
  562.           important information on the use of buffered modems with
  563.           dsz.
  564.  
  565.           Information on the ZMODEM Inter Application File Transfer
  566.           Protocol may be found in ZMODEM.DOC, part of YZMODEM.ZOO
  567.           (yzmodem.arc).
  568.  
  569.           C Source code for XMODEM, YMODEM, and ZMODEM transfers is
  570.           included in RZSZ.ZOO.  This file includes a Pro-YAM/ZCOMM
  571.           script to upload a bootstrap file to a Unix system, force
  572.           its compilation, and (if the compilation is successful)
  573.           upload the rz/sz source files.
  574.  
  575.      GT POWER 13.00
  576.           GT Power version 13.00 includes a YMRX.BAT (YMODEM-g
  577.           receive) file with an "rz" command.  You guessed it, "rz" is
  578.           for ZMODEM protocol (the z means ZMODEM!).  Please change
  579.           the file to use the correct "rb -g" for YMODEM-g.  The files
  580.           ZMTX.ARC and GT1300.NOT available on many bulletin boards
  581.           contain useful information for GT Power users.
  582.  
  583.      PROCOMM
  584.           When running under ProComm's Host mode, failure to use the
  585.           CON command may cause Procomm to lock up the computer.  The
  586.           POE and PROZ programs have been popular in interfacing DSZ
  587.           to Procomm's editor gateway.
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 1/10/88)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  599.  
  600.  
  601.  
  602.      VCACHE
  603.           Virtual memory disk caches and ramdisks using 80286 extended
  604.           memory require a hardware reset of the 80286 chip to return
  605.           to the normal "real mode" after accessing extended memory.
  606.           This interference to the interrupt response time causes lost
  607.           characters on comm ports, and may be minimized by specifying
  608.           shorter memory transfers.
  609.  
  610.      BULLETIN BOARDS
  611.           When installing dsz on a bulletin board or host system, be
  612.           sure to check for proper operation when the caller hangs up
  613.           while a file is being sent or recieved.
  614.  
  615.           Currently, Only the TurboC version supports file sharing
  616.           (shared read access on files sent by  dsz).
  617.  
  618.           Some bulletin board interface routines do not call dsz to
  619.           send a file until they have verified the file's existience
  620.           by opening the file.  If this checking is done in MS-DOS's
  621.           default exclusive open mode, dsz's file sharing will be
  622.           defeated.
  623.  
  624.      NOTES
  625.           If you have difficulty getting dsz to work, start with the
  626.           following command to dsz directly from the DOS prompt,
  627.           without running any other COMM program:
  628.                                         dsz port 1 speed 2400 d t
  629.           (Change the port number and speed as necessary.) This
  630.           connects you to the modem.  Dial a bulletin board by typing
  631.           AT commands to the modem ("ATDP621-3406").  Log in, and
  632.           request a ZMODEM download.  The file will transfer
  633.           automatically.
  634.  
  635.           The "sb" and "sz" commands exploit DOS's tree structured
  636.           file system.  An "sz" command with no file specified sends
  637.           all the files in the current directory.  A directory or disk
  638.           specifier expands to all files in that directory.
  639.  
  640.           DOS 3.x systems may need to have a "STACKS = 8,256" line in
  641.           CONFIG.SYS to prevent antisocial behavior. This is required
  642.           on the NEC Multispeed, or if certain TSR's are used.
  643.  
  644.           A few machines, some with V20 CPUs, don't like DSZ.COM.  We
  645.           have not been able to repeat this; TeleGodzilla (using a
  646.           V20) runs DSZ.COM without a hitch.  Switching to DSZ.EXE has
  647.           cleared up the problems on other machines.
  648.  
  649.           Some XMODEM programs claiming to support YMODEM do not send
  650.           or accept the YMODEM pathname block.  1024 byte XMODEM is
  651.           XMODEM-1k, not YMODEM as defined by Ward Christensen in 1985
  652.           when he coined the word.  1987 versions of YMODEM.DOC remind
  653.           the reader of the official YMODEM definition.
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 1/10/88)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  665.  
  666.  
  667.  
  668.           32 bit CRC code courtesy Gary S. Brown.
  669.  
  670.           Cybernetic Data Recovery(TM), Error Containment(TM),
  671.           OverThruster(TM), Password Guardian(TM), CryptoScript(TM),
  672.           and TurboDial(TM) are Omen Technology trademarks.
  673.  
  674.           PowerCom was trademarked in 1985 by POLYTRON Corporation,
  675.           Hillsboro Oregon.
  676.  
  677.           Dsz and this documentation are Copyright 1988 by Omen
  678.           Technology Inc, all rights reserved.  True YMODEM(TM) is an
  679.           Omen Technology Trademark signifying YMODEM protocol support
  680.           that meets the full YMODEM specification.
  681.  
  682.      FILES
  683.           ZCOMMDOC.ARC, ZCOMMEXE.ARC, ZCOMMHLP.ARC, YZMODEM.ZOO
  684.           (yzmodem.arc) (Official XMODEM, YMODEM, and ZMODEM Protocol
  685.           Description), RZSZ.ZOO (rzsz.arc) (Unix/Xenix source code),
  686.           2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, 2T-PIF.DVP DSZ.COM, DSZ.DOC
  687.           (this file).
  688.  
  689.           DSZ.EXE compiled with the Xenix to DOS XC provides
  690.           moderately higher maximum throughput (1700 vs 1300 cps
  691.           downloading to a 4.77 mHz XT).  The speed difference is a
  692.           function of the compiler, the source code is the same.  The
  693.           Xenix XC version requires more memory, and does not support
  694.           file sharing or a large I/O buffer.  This version is
  695.           available in DSZEXE.ZOO.
  696.  
  697.           ZCOMM and Pro-YAM also run at a higher speed than DSZ.COM.
  698.  
  699.           Incompatible batch files may cause dsz to fail.
  700.  
  701.      LICENSING INFORMATION
  702.           Dsz is a user supported program developed and supported by
  703.           Chuck Forsberg.  It has taken countless hours of work and
  704.           considerable resources to develop and support dsz in the
  705.           myriad environments users use it.  Unlike snazzy menu
  706.           interfaces, developing high performance transfer protocols
  707.           takes many hours of testing.  Help fight the high cost of
  708.           software by supporting high quality shareware.  Thank you
  709.           for your support.
  710.  
  711.           Dsz is not and never has been public domain.  Every version
  712.           of dsz has included a Copyright Notice and a prohibition
  713.           against sale or modification.
  714.  
  715.           Dsz is not free software.  If you use this program, you
  716.           ought to register it.
  717.  
  718.           This documentation file and the MAILER file must be provided
  719.           with all copies of DSZ except by prior written permission
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 1/10/88)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  731.  
  732.  
  733.  
  734.           from Omen Technology Inc.  No version of dsz may be
  735.           modified, patched, hacked, disassembled, decompiled, or
  736.           otherwise reverse engineered, or sold, without prior written
  737.           permission by Omen Technology Inc.
  738.  
  739.           Distribution of dsz in any medium without this documentation
  740.           file constitutes an unauthorized modification.
  741.  
  742.           If dsz is distributed with any other product, software or
  743.           hardware, the product documentation must clearly and
  744.           promimently state that the customer's continued use of dsz
  745.           requires registration directly with Omen Technology or its
  746.           duly authorized agent(s).  When dsz is distributed on disk,
  747.           a contemporary copy of ZCOMMDOC.ARC must be included on the
  748.           same disk.
  749.  
  750.           After an initial short evaluation period, users should
  751.           register their copy of dsz with a check for $20.00 in U.S.
  752.           funds sent to:
  753.  
  754.                  Omen Technology Inc.
  755.                  P.O. Box 4681
  756.                  Portland, OR 97208
  757.  
  758.           Don't bother scrounging for an envelope, use the INSTANT
  759.           MAILER included in this archive!
  760.  
  761.           Users, especially those overseas, may choose to register
  762.           their copy of dsz for $25.00 U.S.  by providing their VISA
  763.           or Mastercard card number with expiration date and their
  764.           name as it appears on their card.
  765.  
  766.           ***********************************************************
  767.           The USER registration package includes a serial number, the
  768.           latest DSZ programs, the installation program which enables
  769.           features and bypasses the opening advertisement, and
  770.           additional documentation.
  771.  
  772.           The registration package serializes all past and future
  773.           versions of DSZ.COM and DSZ.EXE.
  774.           ***********************************************************
  775.  
  776.           The putsnp program inserts YOUR DSZ, ZCOMM, PowerCom, or
  777.           Pro-YAM Serial Number Password (SNP) into you copy of DSZ:
  778.                  putsnp dsz.com
  779.           Putsnp accepts your SNP and asks appropriate questions
  780.           before inserting the SNP.
  781.  
  782.           The only legitimate way to disable the opening advertisement
  783.           in dsz is to insert an authorized SNP obtained from Omen
  784.           Technology into dsz with the putsnp program.  Any other
  785.           suppression or modification of the opening screen is
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 1/10/88)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  797.  
  798.  
  799.  
  800.           illegal, unethical, and prohibited.
  801.  
  802.           Distribution of programs and/or instructions on how to
  803.           modify, patch, disassemble, decompile, or otherwise reverse
  804.           engineer dsz without prior written permission by Omen
  805.           Technology Inc is a theft of services and a violation of
  806.           federal copyright law, and will be referred to the FBI for
  807.           investigation and prosecution under federal conspiricy
  808.           statutes.  Applicable RICO law provides for treble damages
  809.           and recovery of attorney's fees.
  810.  
  811.           Dsz may be used and copied by bulletin board systems which
  812.           feature the ZCOMM files (ZCOMMEXE.ARC, ZCOMMDOC.ARC,
  813.           ZCOMMHLP.ARC) for downloading.  A Dsz registration and a
  814.           diskette with current versions of the ZCOMM files (for
  815.           bulletin board downloading) will be mailed upon validation.
  816.           Dsz may be registered without charge by sending your
  817.           bulletin board's address, telephone number and a valid
  818.           login.
  819.  
  820.      CHANGES
  821.           Be sure to save the serial number/password card and putsnp
  822.           program you received from Omen to use with future versions
  823.           of DSZ you download!
  824.  
  825.           1-9-87 Code was added to prevent hanging with the Intel
  826.           82510 UART chip used in newer Intel add in boards (and
  827.           possibly elsewhere).  More instructions were added to the
  828.           NOTES chapter of this document.
  829.  
  830.           12-28-87 Spurious ACKs in the YMODEM-g "rb -g" command were
  831.           eliminated.  The -g option now works with the "rx" command
  832.           to support so called "ymodem g" programs that are not YMODEM
  833.           at all (rx -g file.ext).
  834.  
  835.           Some systems generate incorrect disk free space counts,
  836.           preventing valid transfers; this check has been eliminated.
  837.  
  838.           12-14-87 The minimum dynamic subpacket length is now 32.
  839.           MAXBYTES now works for large values.
  840.  
  841.           12-10-87 Documentation enhanced, ds.bat fixed.  12-6-87 New
  842.           features for bulletin board operators: The "S" option
  843.           interrogates the other program's serial number (sz -S
  844.           file...) when sending file(s) with ZMODEM.  The serial
  845.           number has been added to the the log file (last field).
  846.           Operation of the -S option has been checked with various
  847.           versions of DSZ, ZCOMM, Pro-YAM, Unix rz, and Opus.
  848.           Programs derived from the Unix rz source code tend to return
  849.           the receiver's capability as serial number, but this is no
  850.           great loss as those programs don't have a serial number
  851.           anyway.
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 1/10/88)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  863.  
  864.  
  865.  
  866.           The MAXBYTES environment variable may be used to limit the
  867.           number of bytes transferred.
  868.  
  869.           11-26-87 DSZ.COM is compiled with a newer version of TurboC,
  870.           which may affect operation (hopefully for the better) on
  871.           marginally compatible systems that previously induced
  872.           irreproducible dysfunctions.  This version still accepts the
  873.           TurboC tiny model startup patch, but the patched program
  874.           requires slightly more memory than before.
  875.  
  876.           Sending at 2400 bps, the ZMODEM subpacket length now jumps
  877.           to 1024 after the first 4k (if no errors).  This will
  878.           improve throughput by a small but measureable amount.
  879.           (NOTE: Do not confuse the ZMODEM subpacket length with
  880.           XMODEM's 128/1204 block length.)
  881.  
  882.           When DSZ detects carrier loss, it now waits 2 seconds for
  883.           the modem to stabilize before exiting.  The D command was
  884.           added.  These enhancements may help the program or "door
  885.           interface" calling DSZ to recover from carrier loss more
  886.           reliably.
  887.  
  888.           YMODEM screen display cosmetics have been improved.  DSZ now
  889.           displays its exit status as it exits.  10-27-87 DSZ now
  890.           sends and displays the total number of bytes, and displays
  891.           the estimated time to send all of the files in the batch..
  892.           10-25-87 A bug fix for the distributed Demo of GT Power
  893.           13.00 is included.
  894.  
  895.           The ZCOMM/Pro-YAM "ro" command and O parameter been added
  896.           for XMODEM OverThruster(TM) downloads.  With clean lines,
  897.           OverThruster can speed up network XMODEM downloads
  898.           considerably, enough to pay for registration quickly.
  899.           Typical values for the "O" parameter are 20 to 35 for
  900.           regular modems, 60 for MNP modems. They vary widely on
  901.           different systems and even between ports on the same
  902.           network.  For XMODEM downloads from Compuserve, the "O"
  903.           parameter should be set to 0.
  904.           EXAMPLE: "dsz pO35 ro speedy.fil"
  905.  
  906.           The "w[N]" option was added to allow an easier way to
  907.           specify a window size for the "sz" command over PC Pursuit.
  908.           A missing N gives a window size of 4096.  This option allows
  909.           the DSZOPT environmet string to set the window size.
  910.  
  911.           The ZCOMM/Pro-YAM "t" option (term talk after transfer) has
  912.           been added.  This allows you to enter a description after
  913.           uploading a file to a bulletin board.
  914.           EXAMPLE: "dsz sz -t stealth.zoo"
  915.  
  916.           Memory requirements have been reduced by eliminating unused
  917.           routines.  The DIRSIZE environment variable is not used;
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 1/10/88)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      DSZ(Shareware)           Omen Technology           DSZ(Shareware)
  929.  
  930.  
  931.  
  932.           files are sent in directory order.
  933.  
  934.           10-15-87 Disables file sharing calls on DOS levels less than
  935.           3.x.  Registered copies recognize "t -8g" as well as a
  936.           trailing "8g" in DSZOPT.  10-6-87 English command error
  937.           explanations have been reinstated.  For registered programs
  938.           only, the ZONE and DSZOPT environment variables were added.
  939.           The z parameter now works.  The -r option (Crash Recovery)
  940.           is now intelligent, checking for discrepeancies between the
  941.           old file and the new file.
  942.  
  943.           Acquisition and release of the modem port was enhanced for
  944.           smoother operation in computers multitasking multiple
  945.           communications programs on different ports.
  946.  
  947.           Pirated/hacked versions of DSZ have cost users and dsz's
  948.           developer thousands of dollars in lost time and other
  949.           expenses, in addition to injuring the reputation of Omen
  950.           Technology and its products.  Regrettably, Omen Technology
  951.           cannot support prior versions of dsz because of this piracy.
  952.  
  953.           Name             Length                           Date
  954.           Time   CRC
  955.           dsz.com          46942  Squeezed    9%     42728   9 Jan 88
  956.           3:05a  d013
  957.  
  958.           Your copy of dsz show show this information as provided by
  959.  
  960.                  arc v dsz.arc
  961.           or
  962.                 pkxarc -v dsz.arc
  963.  
  964.           If your copy shows a different CRC or file length, insist on
  965.           a legitimate copy and report the source of the pirated copy
  966.           to Omen Technology Inc.
  967.  
  968.                           Omen Technology Incorporated
  969.                          The High Reliability Software
  970.  
  971.                       17505-V Northwest Sauvie Island Road
  972.                              Portland Oregon 97231
  973.                            VOICE: 503-621-3406 :VOICE
  974.                  Modem: 503-621-3746 Speed 1200,2400,19200 PEP
  975.                         Compuserve:70007,2304  GEnie:CAF
  976.                        UUCP: ...!tektronix!reed!omen!caf
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.      Page 15                                         (printed 1/10/88)
  988.  
  989.  
  990.  
  991.