home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / ZR_B451F.ZIP / ZYRION.DOC < prev    next >
Text File  |  1994-11-05  |  31KB  |  1,035 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                           NOT FOR DISTRIBUTION
  9.  
  10. PLEASE GIVE ME ALSO YOUR FEEDBACK REGARDING THIS DOCUMENTATION WHAT HAS NOT
  11. BEEN READY YET!
  12.  
  13. THANKS CATHY AND FRANS.
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                      (not ready yet for testers only)
  29.  
  30.                        General ZyRion Documentation
  31.  
  32.                                 #421A1CR3#
  33.  
  34.            The ZyRion Inter Application File Transfer Protocol
  35.  
  36.                                    by
  37.  
  38.                               Frans Lupschen
  39.  
  40.                    International Communication Research
  41.  
  42.  
  43.            FreeWare releases by ICR Holland (c) 1990,91,92,93,94
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                        ZyRion Protocol Driver [ BSR<Tm> ]
  51.  
  52.                                 The Division Bell
  53.                          MatrixSoft Systems - Protosoft
  54.                   International Communication Research Holland
  55.  
  56.                      - ZyRion Version 4.23ß Beta Release -
  57.  
  58.                       Coded and Designed by Frans Lupschen
  59.                    The nice name ZyRion by Marlin Lee England
  60.                           Corrections by Cathy Warner
  61.  
  62.                        The First help (1991) by John Lots
  63.             The Idea adapted from Chuck Forberg's ZModem to develope
  64.                          this reliable transfer protocol
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77. ==============================================================================
  78.   Please be so kind as to read the whole documentation. It will prevent
  79.   that you'll end up with questions to others, or ZyRion support sites.
  80.  
  81.   No part of this publication may be reproduced without the prior written
  82.   consent of the copyright holders. All brand and product names mentioned
  83.   in this publication are trademarks or registered trademarks of their
  84.   respective copyright holders.
  85. ==============================================================================
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94. Page                                                                              -----------
  95.  
  96.  1 ....................................... ZyRion "General info"
  97.  
  98.  2 ....................................... Compatible Versions
  99.  
  100.  3 ....................................... Legal Stuff
  101.  
  102.  4 ....................................... SAP, FOSSIL, OS/2, ISDN
  103.  
  104.  5 ....................................... Setup
  105.  
  106.  6 ....................................... Environment Variables
  107.  
  108.  7 ....................................... Black List Data file
  109.  
  110.  8 ....................................... Secure Key information
  111.  
  112.  9 ....................................... -P parameter
  113.  
  114.  10 ...................................... -B Parameter
  115.  
  116.  
  117. Page
  118.  
  119.  11 ...................................... -C Parameter
  120.  
  121.  12 ...................................... Control Send File [ @ Parameter ]
  122.  
  123.  13 ...................................... DTE Rate
  124.  
  125.  14 ...................................... Connect Rate
  126.  
  127.  15 ...................................... Normal Baudrate
  128.  
  129.  16 ...................................... ISDN Information
  130.  
  131.  17 ...................................... RVC [ Real Voice Chat ]
  132.  
  133.  18 ...................................... DFC Matrix
  134.  
  135.  19 ...................................... Internal cache (Receive)
  136.  
  137.  20 ...................................... OS/2.? and ZyRion
  138.  
  139.  
  140. Page
  141.  
  142.  21 ...................................... Windows and ZyRion
  143.  
  144.  22 ...................................... Windows NT and ZyRion
  145.  
  146.  23 ...................................... ZModem and ZyRion
  147.  
  148.  24 ...................................... ZyRion and BBS Systems
  149.  
  150.  25 ...................................... ZyRion and Terminal packages
  151.  
  152.  26 ...................................... Error Rate
  153.  
  154.  27 ...................................... Speed [ Bits Per Second ]
  155.  
  156.  28 ...................................... Questions and Answers
  157.  
  158.  29 ...................................... Encode/Decode AVWIT engine
  159.  
  160.  30 ...................................... Problem analyses
  161.  
  162.  
  163. Page
  164.  
  165.  31 ...................................... Screen Layout
  166.  
  167.  32 ...................................... UARTS
  168.  
  169.  33 ...................................... Overruns (RTS/CTS)
  170.  
  171.  34 ...................................... The old song
  172.  
  173.  35 ...................................... The Devision Bell
  174.  
  175.  36 ...................................... Extra Information
  176.  
  177.  37 ...................................... Los Endos
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209. ZyRion General Info.            Page   - 1 -
  210. --------------------
  211.  
  212. ZyRion is a stand alone File Transfer Protocol. The purpose is to transfer data
  213. as fast as possible over public phone lines, keep error rates low, and most -
  214. important keep the user interface friendly.
  215.  
  216. And at last ZyRion is NOT a ZModem hack, it uses new advanced features like  -
  217. a replacement of the CRC calculations due to the transfer, These calculations
  218. will cost CPU time, and CPS rates might drop on slow PC's. You will say "Wrong"
  219. because CRC32 or CRC16 calculations cost just a short time. Well thats already
  220. too much due to the fact that we want a data flow that is fast and reliable, -
  221. and fast. I'm not refering to the Modem's speed. This is just the Async low -
  222. level init speed based on DTE rates or just real connect rates without having
  223. a locked DTE rate.
  224.  
  225. BSR or Bit Shift Rotation is based on a total new concept. It will handle the
  226. binary sequence in a NON ASCII method, and there is a DFC Matrix table that -
  227. uses variable byte output streams. Sometimes one byte can be 5 bits sometimes
  228. 7 bits etc..... In that order we gain speed without increasing the baudrate, -
  229. and that is the heart of ZyRion.
  230.  
  231.  
  232. A special bit will be used for Sync and Matrix check on a 8 by 8 matrix buffer
  233. sequence to ensure 100% error free packet transmissions or re-transmissions.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255. Abstract (Can be skipped, if its not in your interrest)
  256. -------------------------------------------------------
  257.  
  258. The ZyRion file transfer protocol provides reliable file and command
  259. transfers with complete END--TO--END data integrity between application
  260. programs.  ZyRion's BSR/32/DFC protects against errors that continue to
  261. sneak into even the most advanced networks.
  262.  
  263. Low error rate : Unlike traditional and many recently introduced protocols,
  264. ZyRion safeguards all data and supervisory information with effective error
  265. detection  and in one  stroke [Sbyte] correction. ZyRion  rapidly transfers
  266. files, particularly  with buffered  (error correcting)  modems, timesharing
  267. systems, satellite relays, and wide area packet switched networks.
  268.  
  269. User Friendliness is an important ZyRion feature.  ZyRion AutoDownload
  270. (Automatic file Download initiated without user intervention) greatly
  271. simplifies file transfers compared to the traditional protocols.
  272.  
  273.  
  274. ZyRion provides advanced file management features including Crash
  275. Recovery, flexible control of selective file transfers, and security
  276. verified command downloading.
  277.  
  278. ZyRion has advanced Async management features for DOS, OS2, WIN/NT and
  279. more, If no external device driver like X00, or SIO has been detected
  280. it will switch to a advanced internal driver called SAP.
  281. The SAP Driver will enable auto sence for timeslice and other needed time
  282. slice stuff, this is also the case in external mode.
  283.  
  284. ZyRion DFC based control is flexible during Bit Rotate Shift calculated
  285. 32 bit phase shift in shift out bit by bit sequence to get the best and
  286. reliable matrix buffer, wich will send 10 bits all the time, 1 stop 8 data
  287. bits and 1 start bit. This advanced technic is the key of ZyRion's speed.
  288.  
  289. Since 2.5 of a byte can be transfered in one 10 bits stroke, in other words
  290. 2 bytes "65 66" "A B" will only take up 10 bits, not 20 bits or 8 bits and not
  291. 16 bits (if we exclude the start and stop bits).
  292.  
  293. In high bit mode this BSR routine uses variable phase Bit Shift Rotation to
  294. manage Short and Long bit streams. This technic IF enabled will pass another
  295. routine called B.E.B or Byte Encoded Byte to ensure that the receiver will -
  296. Decode the BEB byte in the proper way, since it might be that in one BEB are
  297. two binary sequences ONE complete byte and one part byte of the next shift in
  298. byte to be passed. A Sync bit will be inserted to ensure low error rate at all
  299. cost.
  300.  
  301. Older _versions_ of ZyRion will escape this SB (Sync Bit) to gain more speed -
  302. however this  can lead to  unrecoverable _BSR sequences, therefore I decided -
  303. in this version NOT to escape this SB, and here  comes the new name from NOT -
  304. DFC mode but BSR mode, as a matter of fact BSR/32 is a new advanced DFC, -
  305. technical but still compatible with the older DFC technic!
  306.  
  307. ZyRion protocol features allow implementation on a wide variety of systems
  308. operating in a wide variety of environments. A choice of buffering and
  309. windowing modes allows ZyRion to operate on systems that cannot support
  310. other streaming protocols. Finely tuned control character escaping allows
  311. operation with real world networks without Kermit's high overhead.
  312.  
  313. ZyRion is the only high performance, high reliability public protocol that
  314. does not require larger buffer allocations for normal file transfers.
  315.  
  316. At this moment I have a BiDirectional version ready for internal Alpha -
  317. testings. It proves that BSR can be used in such a way, but it will still -
  318. take a few months before I can ever release a wide beta!
  319.  
  320.  
  321.  
  322.  
  323.  
  324. Complex ?
  325. ---------
  326.  
  327. ZyRion software is more complex than unreliable X+YMODEM routines, and even
  328. the  reliable _ZMODEM_ has no such complex _SB and BSR_ methods to protect it
  329. against errors that continue to sneak in. Since ZMODEM still uses CRC16 and
  330. CRC32 to protect data packets (512 - 1024) and ZEDZAP (512 - 8192), all these
  331. ZMODEM based protocols are also frame based and Escaping from dirty bytes.
  332.  
  333. ZyRion keeps his data packets on one stream Sbyte hit, with a maximal of -
  334. 4096 bytes for each packet including Sync Bytes.
  335.  
  336. The overlap byte or OByte tells ZyRion (RX site) how many SBytes are waiting.
  337. For example ONE PACKET of 4096 raw data will be reduced by the BSR routine to
  338. 4044 bytes, in that case there is a complete packet, only variable. The 4045 -
  339. byte will be the OByte ones the OByte has been received the next waiting data
  340. will be shifted into the _matrix buffer_ to get a full raw 4096 bytes data
  341. packet. Is the Packet 3840 bytes, then byte 3841 will be the OByte etc.......
  342. These packets are build in a own internal binary array wich is not compatible
  343. with the normal _ASCII_ table. This table has a total other variable binary
  344. form and has built up protection on both sides equal to 64 bits. Check before
  345. one SByte hits. This will keep ZyRion at top speed and the error rate low if -
  346.  
  347. a static hit shows up. IF so (BSR_ERROR), the Overlap Byte will be shifted down
  348. 16 bytes or maximal 1024 bytes back, this will prevent to much overhead.
  349.  
  350.  
  351. A disadvantage is when the (BSR_ERROR) shows up just before the SByte has been
  352. sent. In that case ZyRion (like other protocols) needs to shift back one raw
  353. Data Packet to ensure 100% secure and error free re-transmissions.
  354.  
  355. However ZModem needs to do this all the time (resending) one of Data Packets -
  356. with a bad CRC. ZyRion has the advantage that such condition shows up ones in
  357. a BAD while so to speak, but the BSR routine will ensure that the data will -
  358. flow at top speed since the binary bit stream is variable. This will re-gain -
  359. speed since the overhead is low.
  360.  
  361. ZyRion uses "ANTI VIRUS" technics. Don't confuse this with "SCAN" technics
  362. like Virus Scan utilities, thats not the purpose of ZyRion. For that you need
  363. to use one of the many good Virus Scan utilities on the market today like -
  364. F-PROT, TBSCAN etc...... Zyrion protects only itself.
  365.  
  366.  
  367.  
  368.  
  369.  
  370. FATAL INTERACTIONS
  371. ------------------
  372.  
  373. NOTE: For hackers, don't try to remove or change ZyRion in anyway. I know you
  374. are able to do so, but it will disable ZyRion's built in check. I only want to
  375. stress out here that it is not an ANTI HACKERS routine. Even DON'T  UNLZEXE -
  376. "ZyRion.exe". In that case ZyRion will give the message "Infected by ......".
  377. Briefly Zyrion's CRC32 has been stored into the Secure.key in encrypted form.
  378. Also the Size of the current version and extra information are stored in this
  379. Key file.
  380.  
  381. To make it reliable for REAL Virus infections, ZyRion takes its own CRC as a
  382. Longint and this Longint is protected by a CRC16. A small DFC packet at the
  383. end of Zyrion.exe has the same info. to compare the data with the data in the
  384. secure.key. Regardless to any modification with either the key or with ZyRion -
  385. it will enable the Warning routine what will tell you that it might be infected
  386. or modified, so the note for hackers is only "in case" so that users don't
  387. panic, because a modified secure.key or zyrion.exe file will trigger or activate
  388. this routine.
  389.  
  390.  
  391.  
  392.  
  393. This routine will NOT only display the message, but it will also terminate the
  394. compare routine at the tail of the Zyrion.exe file. Result: zyrion will NOT  -
  395. work anymore to prevent "if infected" more damages to the end users computer
  396. hard and/or software, so you as user and other people are warned, so be aware
  397. that this can happen.
  398.  
  399. ZyRion Blacklist operations are simply based on reject inbound files and sent
  400. to the sender. A Skip sequence is in that way that the sender skips to the next -
  401. file "IF ANYWAY".
  402.  
  403. ZyRion will read a file (if Excists) called "BLACKLST.DAT". The format of this
  404. file is plain ASCII, and the syntax is EXE, COM, SYS, BAT etc...... If found,
  405. ZyRion will skip all files which have these extentions.
  406.  
  407. For example my BLACKLST.DAT file :
  408.  
  409. CLOCK$
  410. ZYRION.EXE
  411. COM
  412. SYS
  413. BAT
  414.  
  415.  
  416. This will skip CLOCK$, ZYRION.EXE (ONLY) and all (.COM .SYS .BAT) Files.
  417.  
  418. Real Voice Chat (RVC) "registered/Pro" versions only, if enabled it will -
  419. truncate each packet before the next shift in procedure and will insert
  420. a data voice packet to advoid low CPS rates. ZyRion uses a two way SByte to -
  421. stay in sync.
  422.  
  423. You need at least a SoundBlaster/Pro-16. All complete checked data will be
  424. shifted in and out using the proper DMA channel in use to gain/keep speed.
  425.  
  426. You just need a microphone, speaker, or headset and while the transfer is -
  427. in progress you can speak with the remote site in full digitized sound "Mono".
  428.  
  429. For more information about the ZyRion/Rvc-Pro call 31-45-256961 21K8!
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. ZyRion Header structure (Auto Download).
  440. ----------------------------------------
  441.  
  442. If your terminal can handle Auto Download sequences, then it needs to look for
  443. this header string :
  444.  
  445. zsE000000000000 OR zs//E000000000000 if the remote uses a RVC Version.
  446.  
  447. <start><Padding 2 times><BiSync><DFC Indicator><Hex sequence>
  448.  
  449. In these days mutation "Scrambled" Viruses sneak in or P&S attacks are
  450. modernized. ZyRion has a anti crypted shield to advoid such attacks.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462. Compatible Versions             Page   - 2 -
  463. -------------------
  464.  
  465. Mainly all FREE releases are compatible with each other, headers and other -
  466. handshake characters have not been changed.
  467.  
  468. But internal there are a lot of changes to gain more througput. For example if
  469. somebody uses ZyRion 4.09F and you as end user use ZyRion 4.21F then the new -
  470. ZyRion will be faster in transmit mode, so don't check over and over your setup
  471. or hardware, but use allways the last new release.
  472.  
  473. NOTE : ZyRion versions before 4.04 will NOT work!
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486. Legal Stuff                     Page   - 3 -
  487. -----------
  488.  
  489. FREE VERSION LICENCE AGREEMENT:
  490.  
  491.  
  492.           A.  This is a licenced agreement between you, the end user, and
  493.               Fransiscus Jan Hendrik Lupschen. The ZyRion 4.21F - FreeWare
  494.               software and information attached hereto, hereafter "ZYRION",
  495.               is the property of Fransiscus Jan Hendrik Lupschen.
  496.  
  497.  
  498.           B.  You acknowledge and agree that ZYRION is a proprietary product
  499.               of Fransiscus Jan Hendrik Lupschen, protected by applicable
  500.               copyright laws and international treaty provisions.
  501.               You further acknowledge and agree that all rights, title, and
  502.               interest in  and to ZYRION <DFC/BSR(Tm) are  and shall remain
  503.               with Fransiscus Jan Hendrik Lupschen.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.           C.  ZYRION may be used for a period of thirty (30) days on a trial
  510.               basis to allow you to determine its suitability for your
  511.               particular application. After this period you MUST register
  512.               each copy of ZYRION that you run simultaneously.
  513.               This is done so we know who has ZYRION software installed.
  514.               Register under these terms does NOT mean you need to pay for
  515.               this Version, if so you will see another notice in this doc.
  516.  
  517.           D.  Registration _entitles_  you to use ZYRION  and any _future
  518.               versions of ZYRION for as long as it has been released as Free-
  519.               Ware X.XXF, subject to any special licensing conditions
  520.               and/or applicable upgrade fees attached to future versions.
  521.  
  522.           E.  In the event that you are in violation of this licence
  523.               agreement, you agree and accept that Fransiscus Jan Hendrik -
  524.               Lupschen may cancel your registration and any rights to use -
  525.               Free ZyRion releases or Commercial releases that you may have.
  526.               In the case of a dispute over the _licence agreement_, you -
  527.               further agree and accept to fully reimburse Fransiscus Jan -
  528.               Hendrik Lupschen for legal and other expenses resulting from
  529.               the dispute.
  530.  
  531.  
  532.           F.  ZYRION is provided "as is", without warranty of any kind or
  533.               fitness for a particular purpose, either expressed or implied,
  534.               all of are hereby explicitly disclaimed.
  535.               Fransiscus Jan Hendrik Lupschen only guarantees that ZyRion -
  536.               will occupy disk space.
  537.  
  538.           G.  Neither Fransiscus Jan Hendrik Lupschen "ICR Holland" nor any -
  539.               of his employees, agents, or other representatives are in any -
  540.               way obligated to provide future versions of, or support for,
  541.               ZyRion.
  542.  
  543.           H.  You may freely distribute and copy ZYRION provided that no fee
  544.               is charged and the _ZYRION<DFC/BSR(Tm)_  distribution  archive
  545.               contains unmodified copies of the original files as produced
  546.               by Fransiscus Jan Hendrik Lupschen.
  547.               Pay Bulletin Board Systems may, however, charge their normal -
  548.               fee provided that no additional charge for ZYRION is levied.
  549.               No part of ZYRION may be modified, altered, reverse engineered,
  550.               sold, or distributed in any form whatsoever which would involve
  551.               some sort of trade without prior  written _permission_ from  -
  552.               Fransiscus Jan Hendrik Lupschen.
  553.  
  554.  
  555.           I.  ZYRION may not be used in any unlawful or illegal manner.
  556.  
  557.           J.  ZYRION Free or commercial may only be used and registered by
  558.               physical  persons for use on equipment, _including_ but  not
  559.               limited to telephone lines, electricity, hardware & software,
  560.               maintained and operated 100% by means of taxed personal income.
  561.  
  562.               ZYRION may not be used to provide commercial services.
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578. FOSSIL Drivers & SAP            Page   - 4 -
  579. --------------------
  580.  
  581. A FOSSIL (Fido/Opus/SEAdog Standard Interface) driver is a memory resident
  582. program (TSR) that works as a layer between the aplication program and your
  583. computer's hardware. ZyRion (In External mode) requires a FOSSIL driver to
  584. function.
  585.  
  586. One of the advantages of the standard FOSSIL interface is that programs can
  587. be ported easily to other machines and/or operating systems, or to communicate
  588. with devices that do not normally function with the SAP, such as ISDN cards.
  589.  
  590. There are several FOSSIL drivers available. ZyRion has been tested with Opus -
  591. Comm, X00, and BNU with good results.
  592.  
  593. X00 and BNU will be described here.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601. BNU
  602.  
  603. BNU, written by David Nugent, comes in two flavors. One is a device driver,  -
  604. the other is a .COM file, loaded from AUTOEXEC.BAT  or another batch file.
  605.  
  606. The .COM flavor is assumed in the example.
  607.  
  608. For a detailed description of the driver, please refer to the  documentation -
  609. included in the BNU distribution archive.  [AUTOEXEC.BAT]
  610.  
  611.                 BNU /R=1024 /T=512 /L1:57600
  612.  
  613.                 /R=1024
  614.                 Specifies a receive buffer of 1024 bytes.
  615.  
  616.                 /T=512
  617.                 Specifies a transmit buffer of 512 bytes.
  618.  
  619.                 /L1:38400
  620.  
  621. Locks COM2 at 57600 BPS (for use with a high-speed modem).
  622.  
  623.  
  624. If you are not using a high-speed modem the above example should most likely -
  625. be modified to not lock COM2.
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647. X00
  648.  
  649. X00, written by Ray Gwinn, is  a _device driver (later versions can also be -
  650. loaded as an executable from AUTOEXEC.BAT), it is loaded from your CONFIG.SYS
  651. file when your machine is started. For a detailed description of the X00 driver,
  652. read the documentation included in the X00 distribution archive.
  653.  
  654.                 [CONFIG.SYS]
  655.  
  656.                 device=X00.SYS E 1 B,1,57600 T=512 R=1024
  657.  
  658.                 E
  659.                 Disable 5 second advertisement when X00 is first loaded.
  660.  
  661.                 1
  662.                 Number of COM ports X00 should allow to be accessed at
  663.                 one time.
  664.  
  665.                 B,1,57600
  666.                 Locks COM2 at 57600 BPS.
  667.  
  668.  
  669.  
  670. X00
  671.  
  672.                 T=512
  673.  
  674.                 Specifies a transmit buffer of 512 bytes.
  675.  
  676.                 R=1024
  677.  
  678.                 Specifies a receive buffer of 1024 bytes.
  679.  
  680. If you are not using a high-speed modem the above example may not be what you -
  681. want. The most common command line for X00 is:
  682.  
  683.                  device=X00.SYS E 1
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693. OS/2 2.x .. Warp etc.
  694.  
  695. ZyRion can be used in an OS/2 DOS box with excellent results.
  696.  
  697. The two drivers described above, BNU and X00, should, however, not be used for -
  698. optimum results. Two drivers that have been tested with good results exist.
  699.  
  700. The first one, VFD for Virtual FOSSIL Driver, written by Joakim Hernberg is a  -
  701. FOSSIL layer that interfaces with the native OS/2 2.x COM driver or compatible -
  702. replacements thereof); the other is SIO/VX00 by Ray Gwinn.
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716. SAP (Serial Async Professional, v8.10.1)
  717.  
  718. The SAP is an internal [I] low level driver, you don't need a FOSSIL. The  SAP
  719. Driver, written by Fransiscus Jan Hendrik Lupschen, takes all Async traffic -
  720. over. It will also control the CTS/RTS, Status Buffering, etc......
  721.  
  722. The command line options for ZyRion remain the same in all situations. There
  723. is one exception you should keep in mind. If you use a FOSSIL (External) or -
  724. the build in SAP (Internal), always be sure that (If you use a Locked rate)
  725. to tell ZyRion to also use the maximum locked rate in the *.PRM File(s). You
  726. can use "ZR-SETUP.EXE" for this purpose. We will discribe that later in this
  727. document.
  728.  
  729. If you want you can enable "Auto dectect". This will force ZyRion to first -
  730. look for a External FOSSIL Driver, and if found use it. If NOT found use
  731. its own SAP. You need to tell ZyRion that the Auto detect mode is enabled by -
  732. using the external setup program.
  733.  
  734. One of the internal SAP Advantages is, that it has no limit (Under/Upper limit
  735. is to pass baudrates). In NON LOCKED mode, you can pass -B300 or -B320 or
  736.  -B3760 Etc...
  737.  
  738. The second SAP Advantage is that it can handle up to 36 serial ports, including
  739. special serial cards. However the standard Free ZyRion release comes with a -
  740. Secure.key that allows you to use a maximum of 4 communication ports.
  741.  
  742. More about SAP and FOSSIL drivers (to compare) in chapter "UARTS"!
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762. SETUP with ZR-SETUP             Page   - 5 -
  763.  
  764. N/A YET
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784. Environment Variables           Page   - 6 -
  785.  
  786. You need to set up some environment variable, but this is easy to do. Just be
  787. sure that you have included the _PATH_ statement in your AUTOEXEC.BAT.
  788.  
  789. The Path statement is needed so that Zyrion knows where all his files are. A
  790. special reason is the security key and some other related files.
  791.  
  792. For Example
  793. -----------
  794.  
  795. Your ZyRion files are located in the subdirectory C:\NET\PROTS, and your path
  796. statement looks like "SET PATH=C:\DOS;C:\NWCLIENT;C:\BP\BIN" then you simply
  797. add "C:\NET\PROTS" to it like this :
  798.  
  799.          "SET PATH=C:\DOS;C:\NWCLIENT;C:\BP\BIN;C:\NET\PROTS"
  800.  
  801. Under an OS/2 session you just do the same. That's all you need to do.
  802.  
  803. If needed you can add another statement to your autoexec.bat, this time its -
  804. for a "LOG" file. ZyRion's LOG file is DSZ compatible.
  805.  
  806.  
  807. If so, add this : SET ZRLOG=C:\NET\PROTS\FILENAME
  808. The Filename can be any name you want, as long as it doesn't exceed the DOS -
  809. limit which is 12 characters (MAX.). See your DOS manuel regarding length of
  810. filenames.
  811.  
  812. for example:
  813.  
  814. "SET ZRLOG=C:\NET\PROTS\ZYRION.LOG" or "SET ZRLOG=C:\NET\PROTS\DSZLOG.LOG"
  815.  
  816. If you have a BBS, just be sure that your BBS is able to read this log!
  817.  
  818. NOTE:
  819.  
  820. If you use RVC then add this statement to your AUTOEXEC.BAT :
  821.  
  822. SET RVC=220,7,2
  823.  
  824. Where 220 is the Address of your soundcard.
  825. Where 7 is the interrupt and 2 the DMA channel!
  826.  
  827.  
  828.  
  829.  
  830. Multi Log Files for Multi Line purposes.
  831. ---------------------------------------
  832.  
  833. MultiLog Files for more lines, ZyRion will create in this case more
  834. seperated LOG files, each log file has been called LINEX.LOG where X is
  835. the current communication port, so -p2 will be LINE2.LOG etc...
  836. You need to set the environment SET MULTILOG=<Drive>\Path <- no backslash -
  837.  
  838.  For Example :
  839.  
  840.  SET ZRLOG=C:\ZR-EXE\ZYRION.LOG     { Normal single line LOG File }
  841.  SET MULTILOG=C:\ZR-EXE             { MultiLine Environment       }
  842.  
  843. In multiLine mode you can left out the ZRLOG= Environment.
  844. However you also need to change in your setup MultiLog to Y = YES!
  845. If you do not so, then NO log will be created unless you use both -
  846. Environments, or only the Single Line Environment.
  847.  
  848. Last note : ZYRION.LOG can be any name you want, but the MultiLog has
  849.             been fixed to LINE1.LOG, LINE2.LOG, LINE3.LOG etc....
  850.  
  851. After the above setup and this section, you need to RE-BOOT your System.
  852.  
  853. Black List Data File            Page   - 7 -
  854.  
  855. Black List means a list of extentions that are not allowed, in short ZyRion
  856. will skip these files.
  857.  
  858. ZyRion will search for a file called "BLACKLST.DAT" and if found it will read
  859. it. After it has been read, Zyrion will process the data in this file.
  860.  
  861. For example EXE, in this case ZyRion will ignore all files with the extention
  862. .EXE, like ZYRION.EXE!
  863.  
  864. I strongly advice you to create this file with one name in it, and that is  -
  865. CLOCK$. CLOCK$ will mess up your system, if somebody try's to upload it.
  866. But if you put it in your black list Data file it will be ignored.
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876. Here is an example :
  877. ------------------
  878. copy con BLACKLST.DAT  (Good)
  879. CLOCK$
  880. EXE
  881. SYS
  882. COM
  883. BAT
  884.  
  885. Don't use wildcards like this :
  886. -----------------------------
  887. copy con BLACKLST.DAT  (Wrong)
  888. CLOCK$
  889. *.EXE
  890. *.SYS
  891. *.COM
  892. *.BAT
  893.  
  894. In this example CLOCK$, all .EXE, .SYS, .COM, .BAT files will be ignored.
  895. Instead ZyRion will send a SKIP header frame to the sender, what basicly
  896. tells the remote "I got this file already" to advoid wrong entries in the
  897. LOG file, if enabled.
  898.  
  899. Secure Key information          Page   - 8 -
  900.  
  901. N/A YET
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922. -P parameter                    Page   - 9 -
  923.  
  924. The -P parameter is the second parameter after SD or RD. -P2 Will tell ZyRion
  925. to use COM2.
  926.  
  927. The SAP Driver (Internal driver) can handle up to 36 communication ports, -
  928. while the External driver "FOSSIL" can handle less communication ports.
  929.  
  930. Refer to your FOSSIL documentation regarding this.
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945. -B Parameter                    Page   - 10 -
  946.  
  947. The -B parameter is the third parameter after -Px, you will only use this -
  948. parameter IF ZyRion has not been locked (NO Fixed DTE rate).
  949.  
  950. The -B2400, or -B9600 are real baudrates NO connect rates, The FOSSIL driver
  951. can only handle some fixed rates like -B300, -B2400, -B9600, -B19200, -B38400
  952. etc..., refer to your FOSSIL documentation.
  953.  
  954. The SAP driver (Internal driver from ZyRion) can handle all baudrates between
  955. 75 - 115200 baud!
  956.  
  957. So -B3412 or -B14400 or -B64000 are LEGAL baudrates, but only for the internal
  958. driver!
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968. -C Parameter                    Page   - 11 -
  969.  
  970. The -C parameter is the third parameter after -Px. You will only use this -
  971. parameter IF ZyRion has been locked (Fixed DTE rate).
  972.  
  973. -C means CONNECT RATE. It can be any connect rate that has been received from
  974. your modem. Your communication package takes care regarding passing connect -
  975. rates to external file transfer protocols.
  976.  
  977. The fixed DTE rate never changes for both SAP or FOSSIL!
  978.  
  979.  
  980.  
  981. Control Send File               Page   - 12 -
  982.  
  983. DTE Rate                        Page   - 13 -
  984.  
  985. Connect Rate                    Page   - 14 -
  986.  
  987. Normal Baudrate                 Page   - 15 -
  988.  
  989. ISDN Information                Page   - 16 -
  990.  
  991. RVC [ Real Voice Chat ]         Page   - 17 -
  992.  
  993. DFC Matrix                      Page   - 18 -
  994.  
  995. Internal cache (Receive)        Page   - 19 -
  996.  
  997. OS/2.? and ZyRion               Page   - 20 -
  998.  
  999.  
  1000. Windows and ZyRion              Page   - 21 -
  1001.  
  1002. Windows NT and ZyRion           Page   - 22 -
  1003.  
  1004. ZModem and ZyRion               Page   - 23 -
  1005.  
  1006. ZyRion and BBS Systems          Page   - 24 -
  1007.  
  1008. ZyRion and Terminal packages    Page   - 25 -
  1009.  
  1010. Error Rate                      Page   - 26 -
  1011.  
  1012. Speed [ Bits Per Second ]       Page   - 27 -
  1013.  
  1014. Questions and Answers           Page   - 28 -
  1015.  
  1016. Encode/Decode AVWIT engine      Page   - 29 -
  1017.  
  1018. Problem analyses                Page   - 30 -
  1019.  
  1020. Screen Layout                   Page   - 31 -
  1021.  
  1022. UARTS                           Page   - 32 -
  1023.  
  1024. Overruns (RTS/CTS)              Page   - 33 -
  1025.  
  1026. The old song                    Page   - 34 -
  1027.  
  1028. The Devision Bell               Page   - 35 -
  1029.  
  1030. Extra Information               Page   - 36 -
  1031.  
  1032. Los Endos                       Page   - 37 -
  1033.  
  1034.  
  1035.