ZyRion 1.00 Windowed Protocol Driver

(C)opyright 1990 by ProToSoFt (Cr) Brunssum

Written by Frans Lupschen

Asynchronous Communication Lib. by Philip R. Burns
ALL RIGHTS RESERVED

DFC(Tm) Data Flow Control by MatrixSoft

Documentation by Marlin L. England







You can receive the latest releases of ZYRION at the following
systems . . .

EUROPE

ProtoVision and Osiris Support Europe
System Operator - Frans Lupschen
(31)45-259666 19:00 -08:00 hours Central European Time
FidoNet 2:284/126

USA

NesByte BBS
System Operator - Larry Nesbitt
(913)441-3420 9600 24 Hours
FidoNet 1:280/12






Table of Contents
PAGE
Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . 1
Distribution Files . . . . . . . . . . . . . . . . . . . . 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . 2
System Requirements and uses . . . . . . . . . . . . . . . 4
Hardware Requirements . . . . . . . . . . . . . . . . . . 5
Software Requirements . . . . . . . . . . . . . . . . . . 6
FIXPORT . . . . . . . . . . . . . . . . . . . . . . . . . 7
ZyRion Parameters . . . . . . . . . . . . . . . . . . . . 8
ZyRion Limits . . . . . . . . . . . . . . . . . . . . . . 9
DiskSpace minimums . . . . . . . . . . . . . . . . . . . . 10
Batch File Examples . . . . . . . . . . . . . . . . . . . 11
The Display and What it Means . . . . . . . . . . . . . . 12
Interfacing ZyRion with a Bulletin Board . . . . . . . . . 13
UARTS, FOSSILS, AND ZyRion . . . . . . . . . . . . . . . . 14
Registration Information . . . . . . . . . . . . . . . . . 15
License Information . . . . . . . . . . . . . . . . . . . 16
Acknowledgments . . . . . . . . . . . . . . . . . . . . . 17
BETA TESTERS NEEDED . . . . . . . . . . . . . . . . . . . 18
Troubleshooting . . . . . . . . . . . . . . . . . . . . .. 19
Additional Products . . . . . . . . . . . . . . . . . . . 20
BETA TESTER Application . . . . . . . . . . . . . . . . . 21
Registration Form . . . . . . . . . . . . . . . . . . . . 22

--- PAGE 1 ---



DISCLAIMER
----------

Protosoft Communication Research & Protovision or ANYONE
belonged to said organizations, will NOT guarantee that
ZyRion will perform in any particular way. The only things we
can guarantee is that it works on our systems, and that it
will take up disk space.

We cannot and will not accept responsibility for any mishaps
to your computer, data, phone line, phone bills or modem.
You will assume full responsibility for the ability or
inability to use this program correctly.
ZyRion is used or sold AS IS with no guarantee at all.




DISTRIBUTION FILES

The Following files should be included with this release . . .

ZYRION.EXE . . . . . . . . . Main Program
FIXPORT.COM . . . . . . . . Program to De-Initialize FOSSIL
ZYRION.DOC . . . . . . . . . This file

If there are missing files, please do Not use ZYRION. Please
call the Support System listed at the beginning of this
manual.

--- PAGE 2 ---

Introduction
ZyRion Revision 1.00

ZyRion may be the worlds fastest file transfer protocol.
At least, none that I've tested can beat it.


ZyRion's derived from the ZEDZAP protocol with special
modifications so that it'll work well with BBS systems
and Terminal programs.

ZyRion has a built in communications manager and doesn't need
any type of fossil, in fact you should make sure you turn the
fossil OFF if running it on a BBS that uses a fossil.


Zyrion has the following capabilities . . .

= DFC, Data stream slaved.
= TRACE after less then 7 errors fixed.
= Another program to Disable the fossil
Fixport (Don't leave it HOT ).
= TM and RM Indicators TM=TRANSMIT MODE RM=RECEIVE
MODE.
= For [ EHS= Extra High Speed ] Buffer size slaved to
stream. Wait status to flush, dep. from the real bps.
= External parameters for Direct or BIOS screen
writes.
= Special handshake between two ZyRion drivers, for
faster Pump up USE DFC-A or DFC-B
= Signal tone, if transfer finished!
= 7 or 8 bit transfer request. For to communicate with
CPM and other 7 bits Systems, Mini Computer Systems e.c
= Parameter input control check, if the parameter on
the Command line was wrong, there will be Pop Up a Full
Help Window.
This is also the case in the local mode.
= If you want to see the full help screen type ZyRion
And then Return, by Send or Receive :
= Port 0, there are people who try to get ZyRion on
line by using Port 0, this is not legal for ZyRion.
Therefore I have build in a Zero Request routine, what
about that, well ZyRion will drop to DOS if the
portnumber is a Zero (0)!
A Zero (Com0) request will be denied.
= REMEMBER ZyRion will NOT make a .LOG file, for BBS
Systems. You have to deal with an Errorlevel, 0 for Good
and 1 for Bad.
= RPT Frame "Receive Protocol Type " in RM.
= TPT Frame "Transmit Protocol Type" in TM.
= NOTE The TPT & RPT Frames will tell ZyRion to adjust the
DFC.
= The RW=Read/Write this will indicate when ZyRion
is Writing or Reading something from your Disk.
In the RM this will be Writing, in the TM this will be Read
= If carrier lost, ZyRion will drop to DOS Errorlevel=1
= New asynchronous Routine Build in for High Speed Modems.

Page 3
= Quick Startup from the Sender. Now Receiver wait
state a bit longer for RPT=Receive HANDSHAKE
Type (Not in the Unregistered Version)
= You will need two ZYRION(s) on both ends.

-> The Best performance you can get is a ZyRion to ZyRion
DFC-B Connection

--- PAGE 4 ---


System Requirements and use


HARDWARE REQUIREMENTS (4)
---------------------
An IBM or Clone, with a minimum 256 kb memory to work with
ZyRion.

Any terminal program can be used, if it has an External
Gateway. Here the memory Requirement depends what
your terminal program needs.

ZyRion can work with ( +/- 50 kb ), further you need one
communication port [ RS232 ], an Internal modem can be used
also, some modems (internal) DO NOT WORK WITH ZyRion!
If you have an External modem, then you have NO problems.

--- PAGE 5 ---

SOFTWARE REQUIREMENTS
---------------------

MS-DOS or PC-DOS, Further you will need to set the CET=-1,
Central Europe Time, minus 1 hour, in your Autoexec.bat
file. The SET CET is only for Europe not for the USA!


***FIXPORT***

Notice = If you are using a FOSSIL, run fixport
before you execute ZyRion. ZyRion has it's
own communications driver and FOSSILs have
a serious effect on how ZyRion executes.

Just type FIXPORT [PORT]

Port is the COMport your FOSSIL is using. For example for
COM1 you would use . . .


FIXPORT 1

And for COM4 you would use . . .

FIXPORT 4

Note for SysOps . . .
FIXPORT will not disable the FOSSIL, it just de-initializes
it for ZyRion. Upon return to your BBS, the FOSSIL will reactivate. You should not have any problems with the FOSSIL.

ZyRion Use:

ZyRion <- or +>

Where <+>=Direct Screen Writes **OPTIONAL**
<->=BIOS screen Writes

=Receive Mode
=Transmit Mode


=COMPORT you are using (1-4 supported)

=Speed of connection
Supported baud rates 300 - 115,200 Baud.

* =Upload or Download directory, depending on
MODE used
**=Filename of File to Send.

(*) Path is not supported in the unregistered Version. The
path will always be the directory ZyRion was started in.
Also there is a 20 second delay before ZyRion drops back
to DOS. Registration will remove these options.



Page 6
(**) Wildcards are okay. That is the only way to send in BATCH
mode. In later releases, there will be a multi-file
option, and a BBS version.

There must be one at least blank space between the parameters
+ S 1 2400 C:\*.*



Examples

< + OR - > S 1 2400 C:\OPUS\*.ZIP

Here ZyRion will send all (ZIP) Files, using communication
port 1 (COM1) At 2400 Baud.

< + OR - > R 1 2400 C:\OPUS\DOWNLOAD\
^ Don't forget this one


Here ZyRion will receive File(s), using communication port 1
(COM1) At 2400 Baud, the files will be stored in
C:\OPUS\DOWNLOAD\
If your communication program puts a *.* behind the path,
like : C:\OPUS\DOWNLOAD\*.*, then ZyRion will ignore the
Wildcard (*.*), all Filename(s) or Wildcards will be filtered
out, if ZyRion is in the Receive mode.
Full help is available by typing ZYRION without parameters,
and will ask you for the parameters.


During execution of ZyRion there are some indicators in the
window, these are . . .
RM = Receive Mode Active
TM = Transmit Mode Active
CD = Carrier Detect Signal

Flow Ctrl is the Flow control check, it will check for
the current flow or DFC-A or DFC-B, also it will display
the Subpacket size in the Transmit mode.

Page 7

ZyRion Limits
-------------

The Max Baudrate ( Save ) is 2400 baud over a normal phone
line, but if you want to use 9600 baud or even 19200 baud
be sure your hard & Software configuration is ok.

The range from ZyRion is from 300 Bps - 115 KB ( tested on a
PC to PC ) connection, ( Null Modem ).

You can use port 1 - 4, that is COM1 - COM4.

DISKSPACE MIN.
--------------

ZyRion Will check your drive, if the diskspace is LESS then 2
kb, ZyRion will abort the transfer.

This is only the case in the "RECEIVE" Mode (R).

If ZyRion is in the receive mode, both Communication port and
Files are open. If there where no Diskspace check, then
ZyRion drops to DOS and all files & port would be left open.

Therefore the min Diskspace for a safe close from all open
files include communication port.

If the file size from the receiving file is > then the
diskspace ZyRion also will close all files and port, then
ZyRion will Return to DOS.

In both, before dropping to DOS, the errorlevel is set to
one [1].


BATCH FILE EXAMPLES
-------------------

Here are some examples for batch files . . .

SEND.BAT

ECHO OFF
CLS
FIXPORT 1 *FOR USERS OF FOSSIL DRIVERS*
ZYRION + S %1 %2 %3 *YOU MAY HAVE TO REARRANGE THE
PARAMETERS TO SUIT YOUR TERMINALS
NEEDS*

In the above example, you would use direct screen writes and
send with <%1>port <%2>baud rate and <%3>Path and file(s).

Page 7
RCV.BAT

ECHO OFF
CLS
FIXPORT 1 *DE-INITIALIZES COM1*
ZYRION + OR - R %1 %2 %3
OR ZYRION + OR - R 1 %2 C:\BBS\FILES\UPLOADS\ *SYSOPS*
^ DON'T FORGET THE
TRAILING BACKSLASH!

The example above would use BIOS screen writes and use the
same parameters as SEND.BAT.

NOTE - If you know you will always be using the same
parameter, then you can do away with the %? in your batch
files.

For example, if you are a sysop and you know what com port to
use and you have an upload directory, to receive you would use
this . . .

ZYRION + R 1 %2 C:\BBS\FILES\UPLOADS\ <- DON'T FORGET THE "\"

If you are using QModem and you will always call at 1200 Baud
On port 1, then use this in your batch file . . .

ZYRION + OR - S 1 1200 %3
or ZYRION + OR - R 1 1200 A:\

The above example will work for most terminal programs. For
more information on Parameters, please consult your terminal
manual.




























THE Display and what it means
-----------------------------

The Transfer window, displays on the first line the File name
, on the second line the File Size, then the Blocks in that
file, if in Transmit mode, the current byte, current block,
Error count, ZModem Frame called Last Frame, Current Speed,
and Last message.
When you are sending a file or files ( batch * ), then you
will see by last message getting information.
At this point ZyRion is setting up all info between the
receiver and transmitter.
If done the transfer starts . . .


ZyRion AND BULLETIN BOARDS
---------------------------

It's not hard to install ZyRion, on Bulletin Boards. Just pass
the baudrate, port and filename(s), or if in receive mode
only the Upload path.
Please consult your BBS Manual on Parameters.


UARTS & FOSSILS & ZyRion
------------------------
Depending on your setup, you may to have to change your
in/out buffer size.
ZyRion internal in/out buffer size is 2048 bytes, for your
info.

You may also need to change your UART to get maximum
throughput or file transfer speed.

If you're running an AT, 10 MHZ or faster then you need to
have at least a 16450.
Most systems come with the older, slower 8250's.
If you are running a HST or Telebit, then you need to get
the 16550 or 16650.
If you're running a 386 or a Perstor hard drive controller
then you almost have to have the 16550 or 16650.

Remember this before you get upset, and try to call me about
this, the problems with high speed modems and protocols is
always a matter of setting the things up right.















REGISTRATION
------------

ZyRion may be freely used by Osiris and Isis Owners. If
you do not own Isis or Osiris, ZyRion must be purchased.

OR if you own Osiris or Isis send your serial number to
Protosoft (Cr).
After a check you will receive a full Registered version.
Read also the Registration procedure.

The price is 30 dollars (US Currency).

Mail to :

ProToViSion (Cr) Osiris SE Support node
Frans Lupschen
Vijverstraat 82,
6443 XP, Brunssum, Holland
[ HTMS 3145259666]
FIDO 2:284/126.0


License INFORMATION
-------------------


You are licensed to use your copy of ZyRion on ONLY one system
at a time. You have 30 days to decide if you want to register
your version. After which, you either must pay for it or
erase it. The ShareWare concept is for you. IF you like and
can use this program, then register it within 30 days.

Using it on multiple systems is a direct violation of this
agreement and forfeits all rights you might have pertaining to
upgrades and bug fixes.
























Acknowledgments
---------------

* Turbo Pascal and Tools are Trademarks of Borland inc.
* Turbo Professional
* Abarate and C_Abarated are Trademarks of Frans Lupschen.

Any reproduction of or use of Abarate or C_Abarated in
part or whole is forbidden under The Netherlands Laws.
Include this Document or ZyRion or other OASYS Products.

Those desiring to implement C_Abarate or Abarate Drivers or
ZYRION should contact

ProToSoFt (Cr) - OAsys Software
Vijverstraat 82, 6443 XP, Brunssum
The Netherlands (Z.L)



MY THANKS TO:

Gerald Doene
For his Support on all OASYS programs!

John Lots
For his Support on all Software information for OAZmdm
from release 1.0b to 2.00.

Vincent Veeger
For all his time, to test ZyRion.

Marlin Lee England
For all his time to test ZyRion over the phone line for
LONG Times, and for correcting the documentation.

Jan Janmaat
For all is support to test ZyRion.

Toon Hermans
For all his help to put the Test versions on his System.
For both OAZAP and ZyRion.


















BETA TESTERS NEEDED
-------------------

If you would like to be a BETA tester for ProtoSoft and
Protovision products, Please fill out the application in
appendix C.






















































TROUBLESHOOTING
---------------


Every Block has an error.

FOSSIL is still active. Run FIXPORT before ZyRion.

ZyRion does not place the received file in the right
directory.

1. You are running an UNREGISTERED Version.
In the UNREGISTERED version, you cannot use
the "PATH" parameter. The received file will
be sent to the directory ZYRION was started
from.

2. You forgot to add the trailing backslash to the
upload path.
Place a "\" on the command line like this..

ZYRION + R 1 2400 C:\FILES\UPLOADS\
^
The above example will place the received file
in the UPLOADS directory. Without the
backslash, the received file will be placed in
the FILES directory.
































APPENDIX B Other Products from ProtoSoft




HYPERION . . . . . . . Fast and Small Ansi Terminal

OATERM . . . . . . . . Full Ansi Terminal , Zyrion
Build in .
STM . . . . . . . . . Modem DOS Utility.

OAZMDM . . . . . . . . Windowed ZModem Protocol.

OAZAP. . . . . . . . . ZEDZAP Protocol Also Widowed

FIXPORT . . . . . . . Fossil UnLock Program for the
Most Protocol Drivers Above.




















































APPENDIX C BETA Tester Application

ONLY FOR SERIOUS AND INTERESTED SYSOPS

Please fill out this form and either mail it to ProtoVision or
send it via NET-MAIL to 2:284/126

FULL NAME:
ADDRESS:
:
TELEPHONE NUMBER (VOICE):
(DATA):
BULLETIN BOARD SOFTWARE:
YOUR SYSTEM NAME:
OPERATING HOURS :
MAILER:
FOSSIL (IF APPLICABLE):
MS-DOS VERSION:
NET/NODE ADDRESS:
COMPUTER TYPE:
ALL HARDWARE INFORMATION. INCLUDING BIOS TYPE UP TO MODEM
SPEEDS. :
MULTI-TASKER (IF APPLICABLE):

Please include all the above information. If there are any
special conditions, please list them. We intend to make ZYRION
fully compatible with ALL systems, and we require to know all
about your system.
































APPENDIX D Registration Form for ZyRion



REGISTRATION FOR ZYRION AND ASSOCIATED PROGRAMS

Registration is required for the use of the OAZMDM and ZYRION program series
in a home environment. This form should be used to register a program,
Or Pack.

OAZMDM-N Normal Copy, Only ZModem ( No Protocol Frame ).
OAZMDM-M MultiTask Copy, Only ZModem ( No Protocol Frame ).
OAZMDM-S Special All build in ( Protocol Frame Z,X,Y,FModem ).
ZYRION DFC ZyRion [ 2048/DFC ZyRion ] Fast Transfer.

Registered users of ZyRion receive free technical support and assistance
with ZyRion Setup Problems in the form of walk-throughs
of Problem(s) removal. The ProToSoFt (Cr) Associates CBIS Board is available
(1 line) for access to the latest versions of the ZyRion series

And for downloads of NEW-ZYRION related information. A registered user may
obtain free upgrades of the registered programs for a period of one year
after registration, provided they are downloaded from THIS CBIS.

Diskettes are not mailed to registered users unless specifically requested.
For such mailings, please add $9.

Corporate, business and organizational users require a site license for
the use of the OASYS programs. For site license information please
contact ProToSoFt (Cr) Associates at the address or phone number below.






























=======================================================================

REGISTRATION FORM For Individual Users


PROGRAM: # COPIES: AMOUNT:

OAZMDM-N ($15 per copy) _________ $______________

OAZMDM-M ($25 per copy) _________ $______________

OAZMDM-S ($45 per copy) _________ $______________

ZYRION ($30 per copy) _________ $______________


- ADD $9 for Each Diskette Required $______________
(All four programs and documentation fit on one diskette)

Check Enclosed: (amount) $________________________


OR CHARGE: MasterCard ______ Visa ______

Card Number______________________________________________________

Name on Card______________________________________________________

Expiration Date __________________

Signature _______________________________________



ADDRESS: _____________________________________________________

_____________________________________________________

_____________________________________________________


PHONE : _______________________________________


SEND TO:
ProToSoFt (Cr) Associates Brunssum
Vijverstraat 82
Brunssum 6443 XP

ProToViSion (Cr) 31 45 259666 Use this # for obtaining program upgrades

========================================================================