home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR10 / ZU320WB.ZIP / ZYRION.DOC < prev   
Text File  |  1993-04-21  |  39KB  |  1,025 lines

  1.  
  2. Draft 042193
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              ╔══════════════╗
  9.                              ║  ╔════════╗  ║
  10.                              ║  ║        ║  ║
  11.                              ╚══╝        ╚══╝
  12.                               A product From
  13.                         International Communication
  14.                                  Research
  15.                              ╔══╗        ╔══╗
  16.                              ║  ║        ║  ║
  17.                              ║  ╚════════╝  ║
  18.                              ╚══════════════╝
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                       FIRST PUBLIC BETA RELEASE 3.20.2Wß
  30.  
  31.                           Wide Beta Released Version
  32.  
  33.                        ZyRion<Tm> MatrixScript Encoded
  34.  
  35.      Released By DreamScape "Another break in the wall of Communications"
  36.   Copyright 1990 ,91 ,92 ,93 By International Communication Research Holland
  37.  
  38.                       ZyRion Version 3.20.2.0  [ Level-2 ]
  39.  
  40.                    ZyRion<Tm> Copyright 1993 by Frans Lupschen
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.      LEGAL STUFF
  49.      -----------
  50.  
  51.      T r a d e m a r k s   U s e d
  52.  
  53.      The products listed below are referenced in this manual and we feel that
  54.      proper credit should be given to each for the contribution made to our
  55.      project and the computing community as a whole.
  56.  
  57.  
  58.      BinkleyTerm                            Bit Bucket Software
  59.      BNU                                    David Nugent
  60.      Borland C++, Turbo C++, Turbo Pascal   Borland International
  61.      DESQview                               Quarterdeck Systems
  62.      DoubleDOS                              SoftLogic Systems
  63.      YAM, GSZ, DSZ, ZModem                  Chuck Forsberg
  64.      FrontDoor, TosScan                     Joaquim H. Homrighausen
  65.      IBM, PC-DOS                            International Business Machines,Inc.
  66.      RKPlus [ En/Decryption ]               Scott Davis
  67.      Opus                                   Wynn Wagner III
  68.      QuickBBS                               ---- Unknown ----
  69.      RemoteAccess                           Andrew Milner & Continental Software
  70.      TheDraw                                TheSoft Programming Services
  71.      X00                                    Ray Gwinn
  72.  
  73.  
  74.    ACKNOWLEDGMENTS
  75.  
  76.      * Turbo Pascal is a registered trademark of Borland International
  77.      * OS/2 is a registered trademark of IBM Corporation
  78.      * MS-DOS is a registered trademark of Microsoft Corporation
  79.      * DESQview is a registered trademark of Quarterdeck Office Systems
  80.      * VMiX is a registered trademark of Commercial Software Associates
  81.      * Windows is a registered trademark of Microsoft Corporation
  82.      * MultiDos Plus is a registered trademark of Nanosoft Inc.
  83.      * All other programs are copyright and/or trademarked by their
  84.        respective author unless otherwise noted
  85.  
  86.  
  87.      B e t a   T e s t   T e a m
  88.  
  89.      No amount of thanks is sufficient for the individuals who have assisted
  90.      with ZyRion development.
  91.  
  92.      Listed below are the individuals who served on the beta test teams, or
  93.      as free Sysops who share the time and so on to install ZyRion.
  94.  
  95.      Their assistance has been invaluable.
  96.  
  97.      System Operator .. : Andy Henkelmann            ░░░░░ - 100%
  98.      System Operator .. : Horst Hackenbruch          ░░░░░
  99.      System Operator .. : Christoph Schnerch         ░░░░░ - 90%
  100.      System Operator .. : Axel Golob                 ░░░░░
  101.      System Operator .. : Volker Schultz Berendes    ░░░░░
  102.      System Operator .. : Klaus Schoellhorn          ░░░░░
  103.      System Operator .. : Carsten Schroeder          ░░░░░
  104.      System Operator .. : Michael Reichartz          ░░░░░
  105.      System Operator .. : Wolfgang Schantz           ░░░░░
  106.      System Operator .. : Johannes Blankart          ░░░░░
  107.      System Operator .. : Ronald Dittrich            ░░░░░
  108.      System Operator .. : Reinier De Groot           ░░░░░
  109.      System Operator .. : Rob V/D Hoeven             ░░░░░
  110.      System Operator .. : Dick Hoogendijk            ░░░░░
  111.      System Operator .. : Jaap Huizinga              ░░░░░
  112.      System Operator .. : Frans van.geene            ░░░░░ - 40%
  113.      System Operator .. : Rudi Bijma                 ░░░░░
  114.      System Operator .. : Marlin England             ░░░░░
  115.      System Operator .. : Bill Morris                ░░░░░
  116.      System Operator .. : Robin Moore                ░░░░░
  117.      System Operator .. : Scott Davis                ░░░░░
  118.      System Operator .. : Paul Vandine               ░░░░░
  119.      System Operator .. : TJ England                 ░░░░░ -1%
  120.  
  121.  
  122.      W A R R A N T I E S
  123.      -------------------
  124.  
  125.      By using this software you agree that ICR Holland in no way assumes
  126.      responsibility in any way for the use or misuse of its software.
  127.      In no way is ICR Holland liable for the inability to use any of its
  128.      products.
  129.  
  130.      ICR Holland makes no warranty of any kind, either expressed or implied,
  131.      and no warranty that the program product is free of errors.
  132.  
  133.      C O P Y R I G H T   N O T I C E
  134.      -------------------------------
  135.  
  136.      ZyRion is a copyrighted commercial product of ICR Holland, Inc., a
  137.      privately held corporation with offices located at Brunssum, 6443 XP.,
  138.      The Netherlands, Z.L.
  139.  
  140.            Copyright 1990-1993 International Communication Research.
  141.                             All Rights Reserved
  142.  
  143.  
  144.      Z y R i o n   S h a r e w a r e
  145.      --------------------------------
  146.  
  147.      ZyRion Shareware may be evaluated for sixty days without registration in
  148.      a non-commercial environment.  After sixty days  the  product must be -
  149.      registered or the software removed from use.
  150.  
  151.      The above means you are allowed to use two times a Demo Key, after that
  152.      the above is in effect.
  153.  
  154.      ZyRion Shareware may be distributed under the following terms:
  155.  
  156.      ZyRion may not be modified in any way, for any reason, including but not
  157.      limited to de-compiling, disassembling, or reverse engineering of the  -
  158.      program.
  159.  
  160.      Copyright  notices and  version  information and all  other proprietary -
  161.      program output must never be altered, removed, bypassed or modified by  -
  162.      any means.
  163.  
  164.      You are free to distribute the PUBLICLY AVAILABLE shareware version of  -
  165.      ZyRion to others subject to the above restrictions and also the following:
  166.  
  167.      A. No fee is charged for its use.
  168.  
  169.      B. No remuneration may be accepted for ZyRion. Normal charges for the  -
  170.         method of transmission may be charged.
  171.  
  172.      C. ZyRion must be copied in unaltered form, complete with files containing
  173.         license information, the FULL documentation and all accompanying files.
  174.  
  175.      D. All shareware houses/distribution firms must make explicitly clear that
  176.         the diskette purchase containing any shareware program has NOT been
  177.         registered for use in a commercial environment with ICR Holland.
  178.         Shareware houses and software distribution houses must have a specific
  179.         license from ICR Holland, Inc.
  180.  
  181.      System Operators may make ZyRion available for download only if the above
  182.      conditions are met. If the contents of the archive appear altered or not
  183.      complete, you may obtain the latest release of ZyRion directly from ICR
  184.      Holland, Inc.
  185.  
  186.      Z y R i o n   R e g i s t e r e d
  187.      ---------------------------------
  188.  
  189.      Registered Users will receive a new version which will allow use of
  190.      additional features such as increased speed and more. The registered
  191.      version may not be distributed.
  192.  
  193.      A. ICR Holland authorizes the making of an archival copy of the
  194.         registered software for the sole purpose of backing-up your software
  195.         and protecting your investment from possible loss.
  196.  
  197.      B. The medium on which the registered software is recorded is transferred
  198.         to the customer, but not the title to the software.
  199.  
  200.      D. A single copy of the registered version of ZyRion may be operated on
  201.         more than one computer so long as there is ABSOLUTELY NO POSSIBILITY
  202.         of it being used at one location while being simultaneously used at
  203.         another.
  204.  
  205.      E. ICR Holland is in no way whatsoever obligated to provide support, or
  206.         updates to ZyRion or any other of its software.
  207.  
  208.  
  209.      PREFACE
  210.      -------
  211.  
  212.      Welcome to Another break in the wall of Communications its ZyRion, a
  213.      powerfull Filetransfer protocol.
  214.  
  215.      This Documentation will  help you to Install and  interface ZyRion to
  216.      other communication products, like Terminals & BBS Systems.
  217.  
  218.      If you have still problems after reading this document then I want to
  219.      know all about it.
  220.  
  221.      You can call one of the systems listed in "Sites.txt".
  222.  
  223.      Zyrion currently supports the following multitaskers:
  224.  
  225.      { DETECTION ONLY, USAGE WILL BE ENABLED IN THE NEXT VERSION }
  226.  
  227.      Windows 3.x & NT
  228.      DESQview 2.xx
  229.      DoubleDOS
  230.      VMiX 2.xx
  231.      MultiDos Plus 4.xx
  232.      OS/2 2.0 & 2.1ß
  233.      DOS 5.0 & 6.0 Task Switcher and Compatibles
  234.      TaskView, TopView, OmniView, & Compatibles
  235.  
  236.  
  237.      TECHNICAL LOOK
  238.      --------------
  239.  
  240.      Zyrion Professional (tm)          Full Stream Protocol Driver
  241.      Version 3.20                      Check Type DFC
  242.      Level 2                           Avr. Cps 240 [ 100% ] at 2400 baud
  243.      Status Beta ß (Public)            Timer counts at start YES
  244.      Product Code 0                    MTE Aware YES (tm)
  245.      Date 04/21/93                     Multitask Aware YES
  246.      Data 8 Bits or 7 Bits             2 Bits Extra [ Start/Stop]
  247.      Data Len. complete file           Transport type SDirectional
  248.      Data Sub Len 4096                 Bidirectional Signature Frame
  249.      NC 32 Bits Matrix Check           Ahead Count sender NON
  250.      DC 64 Bits Matrix Check           Byte Count control Sync framed
  251.      Encoded "ZModem type"             RLE NON at this time
  252.      Key security Bidirectional        Destructive on conflict NO
  253.      Resume aborted xfers YES          Headers included by Xfer time YES
  254.      Hold Buffer normal 4096           Hold Buffer MAX [ 32 KB ]
  255.      Reliable at errors YES            Recover Size MAX 2048 or less
  256.      Batch mode YES                    Serial Xfer YES [ Standard RS232C ]
  257.      Ctl File Xfer YES                 Iquiniced on patern search YES
  258.      Constant Abarated YES             Iquinice < > Abarate YES
  259.      Handshake Header 16 Bit CRC       Header has all info
  260.      Auto download in ATTN "Z1"+0      TX byte counter = REAL
  261.      ZINF frame Then user info header  ZINF First H/S Header afterwards
  262.      File Rewind option YES            SUB Packet Rewind YES
  263.      Error correction at ZRPOS         ZRPOS at Pos on Disk
  264.      Error retry count until CAN       CAN Will be send if Abarated decided
  265.      Smart Decided routine YES         Decided is FRAME based
  266.      Bidirectional Frame Returns       Returns on ZSIMPL OFF Request
  267.      Security Frame and header based   MTE Unit "NO INFO RELEASED" (tm)
  268.      Reject strange files YES!         Bit rotation Lo/Hi used for speed!
  269.      Progress Bar  YES                 Avr. repeated TimeSync's 2/10240 bytes
  270.      Extra I/O Check  YES              Ignore Bidirectional Frame  YES
  271.  
  272.  
  273.  
  274.      PREFACE - 2 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  275.      -----------
  276.  
  277.      In early 1986, Telenet funded a project to develop an improved public
  278.      domain application to application file transfer protocol.  This protocol
  279.      would alleviate the throughput problems network customers were
  280.      experiencing with XMODEM and Kermit file transfers.
  281.  
  282.      In the beginning, we thought a few modifications to XMODEM would allow
  283.      high performance over packet switched networks while preserving XMODEM's
  284.      simplicity.
  285.  
  286.      The initial concept would add a block number to the ACK and NAK characters
  287.      used by XMODEM.  The resultant protocol would allow the sender to send
  288.      more than one block before waiting for a response.
  289.  
  290.      But how to add the block number to XMODEM's ACK and NAK?  WXMODEM,
  291.      SEAlink, MEGAlink and some other protocols add binary byte(s) to indicate
  292.      the block number.
  293.  
  294.      Pure binary was unsuitable for ZYRION because binary code combinations
  295.      won't pass bidirectionally through some modems, networks and operating
  296.      systems.  Other operating systems may not be able to recognize something
  297.      coming back unless a break signal or a system dependent code or
  298.      sequence is present.  By the time all this and other problems with the
  299.      simple ACK/NAK sequences mentioned above were corrected, XMODEM's simple
  300.      ACK and NACK characters had evolved into a real packet.  The Frog was
  301.      riveting.
  302.  
  303.      debugging The Source's SuperKermit protocol indicated a window size of
  304.      about 1000 characters was needed at 1200 bps.  High speed modems require a
  305.      window of 20000 or more characters for full throughput.  Much of the
  306.      SuperKermit's inefficiency, complexity and debugging time centered around
  307.      its ring buffering and window management.  There had to be a better way to
  308.      get the job done.
  309.  
  310.      A sore point with XMODEM and its progeny is error recovery.  More to the
  311.      point, how can the receiver determine whether the sender has responded, or
  312.      is ready to respond, to a retransmission request?  XMODEM attacks the
  313.      problem by throwing away characters until a certain period of silence.
  314.      Too short a time allows a spurious pause in output (network or timesharing
  315.      congestion) to masquerade as error recovery.  Too long a timeout
  316.      devastates throughput, and allows a noisy line to lock up the protocol.
  317.      SuperKermit solves the problem with a distinct start of packet character
  318.      (SOH).  ZMODEM and ZYRION use unique character sequences to delineate the
  319.      start of frames.  SEAlink and MEGAlink do not address this problem.
  320.  
  321.      A further error recovery problem arises in streaming protocols.  How does
  322.      the receiver know when (or if) the sender has recognized its error signal?
  323.      Is the next packet the correct response to the error signal?  Is it
  324.      something left over "in the queue"?  Or is this new subpacket one of many
  325.      that will have to be discarded because the sender did not receive the
  326.      error signal?  How long should this continue before sending another error
  327.      signal?  How can the protocol prevent this from degenerating into an
  328.      argument about mixed signals?
  329.  
  330.      SuperKermit uses selective retransmission, so it can accept any good
  331.      packet it receives.  Each time the SuperKermit receiver gets a data
  332.      packet, it must decide which outstanding packet (if any) it "wants most"
  333.      to receive, and asks for that one.  In practice, complex software "hacks"
  334.      are needed to attain acceptable robustness.
  335.  
  336.      For ZYRION, we decided to forgo the complexity of SuperKermit's packet
  337.      assembly scheme and its associated buffer management logic and memory
  338.      requirements.
  339.  
  340.      Another sore point with XMODEM and WXMODEM is the garbage added to files.
  341.      This was acceptable with the old CP/M files which had no exact length, but
  342.      not with newer systems such as PC-DOS and Unix.  YMODEM uses file length
  343.      information transmitted in the header block to trim the output file, but
  344.      this causes data loss when transferring files that grow during a transfer.
  345.  
  346.  
  347.      GENERAL  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  348.      -------
  349.  
  350.      All file transfer protocols make tradeoffs between throughput, reliability,
  351.      universality, and complexity according to the technology and knowledge base
  352.      available to their designers.
  353.  
  354.      In the design of ZYRION, three applications deserve special attention, these
  355.      are the same as ZMODEM does.
  356.  
  357.      + Network applications with significant delays (relative to character
  358.        transmission time) and low error rate
  359.  
  360.      + Timesharing and buffered modem applications with significant delays
  361.        and throughput that is quickly degraded by reverse channel traffic.
  362.  
  363.        ZYRION's economy of reverse channel bandwidth allows modems that
  364.        dynamically partition bandwidth between the two directions to operate
  365.        at optimal speeds.  Special ZYRION features allow simple, efficient
  366.        implementation on a wide variety of timesharing hosts.
  367.  
  368.      + Traditional direct modem to modem communications with high error rate.
  369.  
  370.        ZYRION is not optimized for optimum throughput when error rate and
  371.        delays are both high.
  372.  
  373.  
  374.      This tradeoff markedly reduces code complexity and memory requirements.
  375.      ZYRION generally provides faster error recovery than network compatible
  376.      ZMODEM implementations.
  377.  
  378.      In the absence of network delays, rapid error recovery is possible, much
  379.      faster than TMODEM, ZMODEM, MPT or YMODEM and XMODEM.
  380.  
  381.      File transfers begin immediately regardless of which program is started
  382.      first.
  383.  
  384.  
  385.      ZYRION  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  386.      ------
  387.  
  388.      In some cases, the file length may be unknown, as when data is obtained
  389.      from a process.  Variable length data subpackets solve both of these
  390.      problems.
  391.  
  392.      Since some characters had to be escaped anyway, there wasn't any point
  393.      wasting bytes to fill out a fixed packet length or to specify a variable
  394.      packet length.  In ZYRION, the length of data subpackets is denoted by
  395.      ending each subpacket with an escape sequence similar to BISYNC and HDLC.
  396.  
  397.      The end result is a ZDFCX header containing a "frame type", four bytes of
  398.      supervisory information, and its own DFC.  Data frames consist of a header
  399.      followed by 1 or more data subpackets.  In the absence of transmission
  400.      errors, an entire file can be sent in one data frame.
  401.  
  402.      Since the sending system may be sensitive to numerous control characters
  403.      or strip parity in the reverse data path, all of the headers sent by the
  404.      receiver are sent in hex.  A common lower level routine receives all
  405.      headers, allowing the main program logic to deal with headers and data
  406.      subpackets as objects.
  407.  
  408.      With equivalent binary (efficient) and hex (application friendly) frames,
  409.      the sending program can send an "invitation to receive" sequence to
  410.      activate the receiver without crashing the remote application with
  411.      unexpected control characters.
  412.  
  413.      The objects as above are fixed for 8 data bits, and _NOT_ to  its  real
  414.      variable bit coded matrix, each byte can overlap a character.
  415.      An Byte in normal transfer is one character [ all protocols ] handle it
  416.      this way, ZYRION don't.
  417.  
  418.      ZyRion uses a fixed Matrix code table that reduce the overhead of extra
  419.      bits Not compression or RLE, it use his own table for binary transfers.
  420.      The bits are only shifted into the ringbuffer to get 8 bits as a simulated
  421.      byte, REAL one byte can be 5 bits or 8 bits depended on the high or low
  422.      DFC order control frame for the fixed matrix code table.
  423.  
  424.      Going "back to scratch" in the protocol design presents an opportunity to
  425.      steal good ideas from many sources and to add a few new ones.
  426.  
  427.      From Kermit and UUCP comes the concept of an initial dialog to exchange
  428.      system parameters.
  429.  
  430.      ZMODEM generalizes Compuserve B Protocol's host controlled transfers to
  431.      single command AutoDownload and command downloading.
  432.      Security Challenge discourages password hackers and Trojan Horse authors
  433.      from abusing ZMODEM's power.
  434.  
  435.      ZYRION has the advantage of this, we know the technology we need only to
  436.      make it better, The security challenge of ZMODEM is used in ZYRION aswell
  437.      but in another way, it will send a Signature that prevent MTE or other
  438.      related infected remote or local ZYRION protocols.
  439.  
  440.      People design Virus scan technics to prevent futher infections, ZYRION  -
  441.      will prevent the file to be saved to disk IF the Signature fails.
  442.  
  443.      Do NOT confuse this with checking a file while it will be transfered.
  444.  
  445.      Extensive testing has demonstrated ZYRION to be compatible with
  446.      satellite links.
  447.  
  448.  
  449.      THROUGHPUT ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  450.      ----------
  451.  
  452.      Between two single task PC-XT computers sending a program image on
  453.      an in house Telenet link, SuperKermit provided 72 ch/sec throughput
  454.      at 1200 baud.  YMODEM-k yielded 85 chars/sec, and ZMODEM provided
  455.      113 chars/sec.  XMODEM was not measured, but would have been much
  456.      slower based on observed network propagation delays.
  457.  
  458.      Recent tests downloading large binary files to an IBM PC (4.7 mHz
  459.      V20) running ZYRION 3.20.3.8 with table driven 64 bit DFC calculation
  460.      yielded a throughput of 1936 cps on a 19200 bps direct connection.
  461.  
  462.      Tests with TELEBIT TrailBlazer modems have shown transfer rates
  463.      approaching 1600 characters per second for long files.  When files
  464.      are compressed, effective transfer rates of 2200 characters per
  465.      second are possible.
  466.  
  467.      Tests with Dallas 14400/ locked at 38400 modems have shown transfer
  468.      rates approaching 1920 characters per second for long files.
  469.      When files are compressed, effective transfer rates of 3490 characters
  470.      per second are possible.
  471.  
  472.  
  473.      ERROR RECOVERY IN TIMESYNC DFC BASED MODE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  474.      -----------------------------------------
  475.  
  476.      Some tests of ZYRION protocol error recovery performance have been
  477.      made.  A PC-AT with SCO SYS V Xenix or DOS 5.0 was connected to a PC
  478.      with DOS 3.1 either directly at 9600 bps or with unbuffered dial-up
  479.      1200 bps modems.  The ZYRION software was configured to use 2048
  480.      byte data subpacket lengths above 2400 bps, 1024 otherwise.
  481.  
  482.      Because no time delays are necessary in normal file transfers, per
  483.      file negotiations are much faster than with ZMODEM, the only
  484.      observed delay being the time required by the program(s) to update
  485.      matrix coded buffers.
  486.  
  487.      During a file transfer, a short line hit seen by the receiver
  488.      usually induces a DFC error.  The interrupt sequence is usually seen
  489.      by the sender before the next data subpacket is completely sent, and
  490.      the resultant loss of data throughput averages about half a data
  491.      subpacket per line hit.  At 1200 bps this is would be about .75
  492.      second lost per hit.  At 10-5 error rate, this would degrade
  493.      throughput by about 9 per cent.
  494.  
  495.      The throughput degradation increases with increasing channel delay,
  496.      as more data subpackets in transit through the channel are discarded
  497.      when an error is detected.
  498.  
  499.      A longer noise burst that affects both the receiver and the sender's
  500.      reception of the interrupt sequence usually causes the sender to
  501.      remain silent until the receiver times out in 6 seconds.  If the
  502.      round trip channel delay exceeds the receiver's 6 second timeout,
  503.      recovery from this type of error may become difficult.
  504.  
  505.      Noise affecting only the sender is usually ignored, with one common
  506.      exception.
  507.  
  508.      In summation, ZYRION performance in the presence of errors resembles
  509.      that of ZMODEM or TMODEM, ZMAX e.c  Short  bursts cause minimal data
  510.      retransmission.
  511.  
  512.      Long bursts (such as pulse dialing noises) often require a timeout error
  513.      to restore the flow of data.
  514.  
  515.      Unlike traditional and many recently introduced protocols, ZYRION
  516.      Signature Pulse safeguards all data and supervisory information with
  517.      effective error detection.
  518.  
  519.      ZYRION rapidly transfers files, particularly with buffered (error
  520.      correcting) modems, timesharing systems, satellite relays, and wide area
  521.      packet switched networks.
  522.  
  523.      User Friendliness is an important ZYRION feature.  ZYRION AutoDownload
  524.      (Automatic file Download initiated without user intervention) greatly
  525.      simplifies file transfers compared to the traditional protocols.
  526.  
  527.      ZMODEM also has this feature (it was the first one), and ZYRION folows
  528.      this step.
  529.  
  530.      ZYRION provides advanced file management features including Crash
  531.      Recovery, flexible control of selective file transfers, and security
  532.      USER "coded in the key" verified sequence.
  533.  
  534.      ZYRION protocol features allow implementation on a wide variety of systems
  535.      operating in a wide variety of environments.  A choice of buffering and
  536.      windowing modes allows ZYRION to operate on systems that cannot support
  537.      other streaming protocols.  Finely tuned control character escaping allows
  538.      operation with real world networks without Kermit's high overhead.
  539.  
  540.      ZYRION and ZMODEM are the only high performance high reliability public
  541.      protocols that does not require large buffer allocations for normal file
  542.      transfers.
  543.  
  544.      In compare with ZMODEM, ZYRION uses another way to send his packets also
  545.      the CRC method has been taken out of the loop, since DFC was a better -
  546.      method to support the Bit Matrix Shift BMS[HI] and BMS[LO] sequences.
  547.  
  548.      This feature makes ZYRION one of the best protocols on the marked today.
  549.  
  550.  
  551.      BETA TESTER! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  552.      ------------
  553.  
  554.      IF you want to be a beta, please send your personal information to one
  555.      of the ICR/Sites listed in "SITES.TXT"!
  556.  
  557.  
  558.      FREE KEY FOR! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  559.  
  560.      REAL System Operators that can be found in the NODELIST!
  561.      If you are the one, call also one of the systems listed in "SITES.TXT"!
  562.      You'll get more information, what to do, and how it works, to get a free
  563.      SySops Key.
  564.  
  565.      INSTALL
  566.      -------
  567.  
  568.      First "ofcource" unpack the orginal distribution package into a sub -
  569.      directory of your choice.
  570.  
  571.      For example :
  572.  
  573.      C:\MD ZYRION
  574.      C:\CD ZYRION
  575.      C:\ZYRION> ARJ E C:\NEWFILES\ZR320WB.ARJ
  576.  
  577.      Now you need to "EDIT" your "AUTOEXEC.BAT" file, and add this statement
  578.  
  579.      SET ZSE=C:\ZYRION
  580.  
  581.      The ZSE environment is not needed, but it will speedup ZyRion a bit.
  582.  
  583.      Also include a Path statement, IF needed.
  584.  
  585.      SET PATH=C:\ZYRION
  586.  
  587.      IF you need a LOG file include this line :
  588.  
  589.      SET ZRLOG=C:\ZYRION\ZYRION.LOG
  590.  
  591.      Note that ZyRion.log can be any filename you want!
  592.  
  593.      At this point you are ready to - REBOOT - so that the  new Environments
  594.      are active.
  595.  
  596.      SETUPn
  597.      ------
  598.  
  599.      Second type again :
  600.  
  601.      C:\CD ZYRION
  602.      C:\ZYRION> ZYRION SETUPn "Where n=COM1 - COM8 as integer."
  603.  
  604.      For Example IF you want to Setup ZyRion for COM4 type
  605.  
  606.      C:\ZYRION> ZYRION SETUP4
  607.  
  608.      If you have more lines, then simple Setup ZyRion for each line as above
  609.      the range is from 1 - 4 [ UNREGISTERED ], and from 1 - 8 [ REGISTERED ]!
  610.  
  611.  
  612.      SETUP CONFIGURATION
  613.      -------------------
  614.  
  615.      Third step, now  you need to tell ZyRion how your configuration need to
  616.      look like.
  617.  
  618.  
  619.      WALK WITH ME AND LETS SETUP ZYRION!
  620.      -----------------------------------
  621.  
  622.      Here you need to Enter YOUR FULL name, Will be verified if you have
  623.      a "KEY"!
  624.  
  625.      Owner Name Verification [ First and Lastname ]............>
  626.  
  627.      Here you can change the default Async I/O Buffer Size, by Default -
  628.      this is 4096.
  629.      Don't use to big buffers, IF you decide to change the default!
  630.  
  631.      I/O Buffer Size in bytes  [ Press ENTER for Default ].....>
  632.  
  633.  
  634.      IF you use a HIGH SPEED Modem, then you'll need to enter here the
  635.      MAX. DTE Rate in Bits Per Seconds, For Example >38400
  636.      
  637.      IF Locked the -C parameter need to be used, otherwise the -B Parameter
  638.      for this purpose more later in this documentation.
  639.  
  640.      Locked Rate in Bits Per Second [ Press ENTER = NON ]......>
  641.  
  642.  
  643.      Enable/Disable Write Buffer, this option is Default Disabled, however
  644.      IF Enabled it CAN improve your CPS rate!
  645.      IF Enabled it will use an 32 Kbyte RAM Buffer between the I/O Matrix
  646.      System of ZyRion and your HardDisk.
  647.  
  648.      Enable W_Buffer [ 32 Kb -- Default = OFF ] y/N............>
  649.  
  650.  
  651.      This option will Enable a security LOG so you can see who has called
  652.      with a Valid KEY or DEMO KEY or UNREGISTERED.
  653.      By Default this option is ON, Enabled, but IF you don't need it you -
  654.      can Disable it.
  655.  
  656.      Enable Security Log (Create "Secure.log") Y/n.............>
  657.  
  658.  
  659.      IF you have a 16550AFN or other 16550 type installed then you should
  660.      type Y at this point to take advange of the FiFo Buffers!
  661.  
  662.      Use Fifo Buffers [ 16550A..] Only Y/N.....................>
  663.  
  664.  
  665.      IF you have a multitasker installed it would be better to use the -
  666.      Verification I/O sequence, to be sure that DOS  will  verify for  -
  667.      proper read/write operations, Also IF you have a slow system this -
  668.      option need to be set to Y=ON!
  669.  
  670.      This option will slow down ZyRion a litle bit .004% but it is a safe
  671.      way, therefore this option is set by default to ON.
  672.  
  673.      Set Write/Read Verification Y=ON N=OFF [ Default=ON ].....>
  674.  
  675.  
  676.      By Default ZyRion uses Direct Screen writes, but you can Disable this
  677.      method and use BIOS instead.
  678.  
  679.      Use BIOS Screen writes, y/N [ Default = No ]..............>
  680.  
  681.  
  682.      ZyRion will "AUTO READ" your SNP number IF a key excist, otherwise it
  683.      will be Disabled "000000000000" means, No KEY found, UNREGISTERED!
  684.  
  685.      Your Serial Number Password [ ZCR Mode ] SNP..............>000000000000
  686.  
  687.  
  688.      Not recommended BUT if needed you can Drop the connection after a file
  689.      Transfer.  (Default=NO).
  690.      This can be used IF for that line the connection need to be terminated
  691.      after each Transfer.
  692.  
  693.      Drop the connection after Transfer (DTR) y/N..............>
  694.  
  695.  
  696.      How many HEADER Retry's should ZyRion do, before give up (Timeout).
  697.      Default = 12
  698.  
  699.      Header Retry Counter, Sender only [ Default = 12 ]........>
  700.  
  701.  
  702.      This Optional switch looks confused, but it can be usefull.
  703.      IF you logon and you have tag some files on a BBS, then the
  704.      system will ask, Press Enter to start in some cases.
  705.      If this is the case, you can just start ZyRion, and ZyRion
  706.      will handle the "CR-LF" sequence if the start mode = ON.
  707.      Other systems like Osiris SE are waiting for an "S-CR-LF"
  708.      In this case you use "Start mode = SE", IF you don't  -
  709.      like this option use "Start mode = OFF", however it can
  710.      be real usefull to use at least the "ON" Method!
  711.  
  712.      Use BBS Start mode [ OFF=NOT ON=NORMAL SE=NORMAL & SE ]...>
  713.  
  714.  
  715.      This will force the receiver to use a alternate Download Path
  716.      whatsoever, the Download path on the command line, will be  -
  717.      IGNORED!
  718.  
  719.      IF you want a variable Download Parameter use [ ENTER ] here!
  720.  
  721.      Default Download Path, or Press [ RETURN ] for NON........>
  722.  
  723.  
  724.      Here you can define how you want the calculation, in CPS or
  725.      in BPS or in "%"-Efficiency, IF you press Return here "%" -
  726.      will be used (Default).
  727.  
  728.      CPS display unit E)fficiency in % or C)ps or B)ps.........>
  729.  
  730.  
  731.      The IRQ and Base Address can be changed, for example IF your
  732.      communication port uses another IRQ for COM4, then type Y -
  733.      You'll be asked for new IRQ and Base Address, Use this option
  734.      IF you are total sure, that it need to be changed!
  735.  
  736.      Change default communication settings for COM8 y/N........>
  737.  
  738.      IF Y)es you'll be asked for :
  739.  
  740.  
  741.      Base Address, Please enter it as an INTEGER, not as 03F8!
  742.  
  743.      Base Address..............................................>
  744.  
  745.  
  746.      IRQ Line can be given so as it is, 3, 2, 4 , e.c
  747.  
  748.      IRQ Line for this port....................................>
  749.  
  750.  
  751.  
  752.      ZYRION DEFAULT BASE & IRQ LINES ARE
  753.      -----------------------------------
  754.  
  755.      All Ports below are defined as in Chuck Forsbergs DSZ and YAM to stay -
  756.      compatible with GSZ/DSZ/YAM/ZCOMM
  757.  
  758.       Base Address       Irq Line     COMX    Portn   Fossil
  759.      -------------------------------------------------------
  760.  
  761.      BASE1 := 03F8      IRQ1 := 4     COM1      1       0
  762.      BASE2 := 02F8      IRQ2 := 3     COM2      2       1
  763.      BASE3 := 03E8      IRQ3 := 4     COM3      3       2
  764.      BASE4 := 02E8      IRQ4 := 3     COM4      4       3
  765.      BASE5 := 02B8      IRQ5 := 3     COM5      5       4
  766.      BASE6 := 02B8      IRQ6 := 2     COM6      6       5
  767.      BASE7 := 02F8      IRQ7 := 2     COM7      7       6
  768.      BASE8 := 0278      IRQ8 := 2     COM8      8       7
  769.  
  770.  
  771.  
  772.      PARAMETER LIST
  773.      --------------
  774.  
  775.       R <______> First parameter  R = RECEIVE Lower or Uppercase "R|r"
  776.  
  777.       S <______> First parameter  S = SEND Lower or Uppercase "S|s"
  778.  
  779.      -P <______> Second parameter [ -Pn where n = portnumber ]
  780.  
  781.      -B <______> Third parameter  [ -Bnnnnnn Baud rate REAL or 0 = Abarated ]
  782.  
  783.      -C <______> Third parameter  [ -Cnnnnnn Baud rate CONNECT from Modem ]
  784.                  Use this one IF your DTE rate is constant [ LOCKED! ]
  785.  
  786.       @ <______> Send files from control file @SEND.CTL <-- ASCII PLAIN FILE
  787.  
  788.       . <______> In receive mode, indicate current path
  789.  
  790.      Setupn <__> Setup or Re-Setup n where n is the Portnumber
  791.  
  792.  
  793.  
  794.      ZYRION EXAMPLE
  795.      --------------
  796.  
  797.      ZyRion and interface problems are NOT easy for some end users, so let me
  798.      try to help you.
  799.  
  800.      First we know that we need the Port number [ COMX ], the Baudrate in BPS
  801.      and the Up/Download Parameters, or IF Locked the Connect Rate.
  802.  
  803.      A lot of people searching in Docs and compare that with the Docs from -
  804.      protocols, and then they hope that there is a answer somewhere.
  805.  
  806.      Most of the times you got stuck, becauce all kind of variable from the
  807.      Terminal Communication Software.
  808.  
  809.      Lets assume we have a terminal called "TelComm" but you got stuck, now
  810.      there is a simple method to find out what the passed variables are.
  811.  
  812.      Please note that ZyRion will Ignore batch transfers in UNREGISTERED Mode!
  813.  
  814.      Create a batch file called "GETVAR.BAT".
  815.  
  816.      Put in this batch file the following statements :
  817.  
  818.      COPY CON GETVAR.BAT
  819.      ECHO OFF
  820.      CLS
  821.      ECHO %1
  822.      ECHO %2
  823.      ECHO %3
  824.      ECHO %3
  825.      ECHO %4
  826.      ECHO %5
  827.      ECHO %6
  828.      ECHO %7
  829.      ECHO %8
  830.      PAUSE
  831.      ^Z
  832.  
  833.      Now that we have created this batch file, let it call by your terminal -
  834.      package, in our case "TelComm".
  835.      First call this batch file in receive mode, and you'll see something like
  836.      this :
  837.      
  838.      C:\NEWFILES\    [1]
  839.      8               [2]
  840.      N               [3]
  841.      2400            [4]
  842.      4               [5]
  843.  
  844.      Write this down, and do the same in Transmit mode, and you'll see some -
  845.      thing like this :
  846.  
  847.      0                        [1]
  848.      8                        [2]
  849.      N                        [3]
  850.      C:\TEMP\MYFILES\TELEM*.* [4]
  851.      2400                     [5]
  852.      4                        [6]
  853.  
  854.      Write this down to, ofcource you'll get other variables but its for that -
  855.      you got the idea.
  856.  
  857.      Now with the above parameters we can make a ZSend.bat and a ZRcvd.bat for
  858.      ZyRion.
  859.  
  860.      This would be look like this, NOTE: Not locked!
  861.  
  862.      COPY CON ZRCVD.BAT  (Receive)
  863.      ECHO OFF
  864.      CLS
  865.      ZYRION R -P%5 -B%4 %1
  866.      ^Z
  867.  
  868.      You'll get this : ZYRION R -P4 -B2400 C:\NEWFILES\
  869.  
  870.  
  871.      COPY CON ZSEND.BAT
  872.      ECHO OFF
  873.      CLS
  874.      ZYRION S -P%6 -B%5 %4
  875.      ^Z
  876.  
  877.      You'll get this : ZYRION S -P4 -B2400 C:\TEMP\MYFILES\TELEM*.*
  878.  
  879.  
  880.      Now we do the same but this time we know our terminal package is locked
  881.      and ZyRion also at 38400 Bits Per Second DTE rate.
  882.  
  883.      C:\NEWFILES\    [1]
  884.      8               [2]
  885.      N               [3]
  886.      2400            [4]
  887.      4               [5]
  888.      38400           [6]
  889.  
  890.      Write this down, and do the same in Transmit mode, and you'll see some -
  891.      thing like this :
  892.  
  893.      38400                    [1]
  894.      8                        [2]
  895.      N                        [3]
  896.      C:\TEMP\MYFILES\TELEM*.* [4]
  897.      2400                     [5]
  898.      4                        [6]
  899.  
  900.      Write this down to, ofcource you'll get other variables but its for that -
  901.      you got the idea.
  902.  
  903.      Now with the above parameters we can make a ZSend.bat and a ZRcvd.bat for
  904.      ZyRion.
  905.  
  906.      This would be look like this, NOTE: locked!
  907.  
  908.      COPY CON ZRCVD.BAT  (Receive)
  909.      ECHO OFF
  910.      CLS
  911.      ZYRION R -P%5 -C%4 %1
  912.      ^Z
  913.  
  914.      You'll get this : ZYRION R -P4 -C2400 C:\NEWFILES\
  915.  
  916.  
  917.      COPY CON ZSEND.BAT
  918.      ECHO OFF
  919.      CLS
  920.      ZYRION S -P%6 -C%5 %4
  921.      ^Z
  922.  
  923.      You'll get this : ZYRION S -P4 -C2400 C:\TEMP\MYFILES\TELEM*.*
  924.  
  925.      Note: For "NOT LOCKED" you can also use -B0, this will enable the Abarate
  926.      routine, this is a short word for Auto Baud Rate, in other words ZyRion
  927.      will figur out what your UART rate is!
  928.  
  929.      Final the @<control File> option, this can be usefull if you send a lot of
  930.      files, since DOS will not allow that many.
  931.  
  932.      All you need to do is REPLACE the %4 parameter with @MYCTL.CTL
  933.      At this point ZyRion will process the plain Ascii file, your control file
  934.      and ZyRion will send all files listed in this control file in batch mode
  935.      You need to have a registered version for this purpose, since ZyRion will
  936.      NOT allow Batch Transfers in UNREGISTERD Mode!
  937.  
  938.      Sample control file
  939.  
  940.      MYCTL.CTL
  941.      C:\TEMP\FLIB20.ZIP
  942.      D:\DOS\CHKDSK.EXE
  943.      A:\TERM312.ZIP
  944.  
  945.      And so on, you can make this list so long as you want.
  946.  
  947.      In the above Examples we used the method like below :
  948.  
  949.      ZYRION S -P4 -C2400 C:\TEMP\MYFILES\TELEM*.*
  950.  
  951.      But you can also do this :
  952.  
  953.      ZYRION S -P4 -B0 C:\*.ZIP A:\*.ARJ D:\TE*.* B:\*.GIF  [ and so on ].
  954.  
  955.      Thats all you'll need to do, and ZyRion will work!
  956.  
  957.  
  958.      FILES
  959.      -----
  960.  
  961.      You need to set the statement FILES= at least to 20, so FILES=20!
  962.      Otherwise ZyRion will abort, because it need to open a lot of files in
  963.      some cases.
  964.  
  965.      Also the best performance will be on a 386 based PC or better!
  966.  
  967.  
  968.  
  969.  
  970.                            ╔══════════════╗
  971.                            ║  ╔════════╗  ║
  972.                            ║  ║        ║  ║
  973.                            ╚══╝        ╚══╝
  974.                             A product From
  975.                       International Communication
  976.                                Research
  977.                            ╔══╗        ╔══╗
  978.                            ║  ║        ║  ║
  979.                            ║  ╚════════╝  ║
  980.                            ╚══════════════╝
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.