
   HYPERHOW.DOC
   by Tom Collins
   07-09-90

   The Hyperp protocol is a new file transfer protocol that claims to be
   the fastest protocol available.  Whether or not it is, it's a real
   hassle to set up with RBBS.  Since I managed to get it working, I
   thought I'd share my experience.

   Hyperp installs like any other protocol in your PROTO.DEF file, with one
   exception: it won't accept a '-' as part of its logfile name.  If you
   enter "Logfile:C:\RBBS\XFER-1.DEF" as part of its command line, it'll
   refuse to work.  For that reason, it has to be run from a send and
   receive batch file.  You set up Hyperp in PROTO.DEF as follows:

   "R - HyperP [Single File]
   ",0,S,8,,,,,0.85,,2=T,
   "HYPERS.BAT [BAUD] [PORT#] [FILE]",
   "HYPERR.BAT [BAUD] [PORT#] [FILE]"

   (The last three lines, of course, are on one line in PROTO.DEF)

   With this setup, HYPERS.BAT and HYPERR.BAT see the baud rate as %1, the
   port number as %2, and the filename as %3.

   Hyperp is set up as a single-file protocol (since it doesn't support
   RBBS' method of batch downloads), with an efficiency of 0.85 (it may be
   higher...) and no defined block size.

   The strange thing about Hyperp is how it writes to the logfile.  If it
   is receiving a file, and the file is received OK, the logfile contains
   two lines, and the second line says something like:

      Written to: D:\RBBS\UPLD\TEST.ZIP

   If the receive fails, it writes something file:

      Transfer Aborted

   to line two of the log file.  On an aborted send, Hyperp's logile looks
   just like the aborted receive logfile.  However, on a successful send,
   Hyperp only writes one line to its logfile.  This confuses RBBS and
   makes it think that the transfer was aborted, even when it wasn't.  The
   solution is to append a dummy line to the logfile on a Hyperp send.
   This makes RBBS happy, and when it doesn't find the "failure string" in
   the second line of the logfile, RBBS assumes the transfer went OK.

   The batch files and a sample PROTO.DEF file are included in this ZIP.
   You should be able to modify them for your BBS.

   Good luck...

   -- Tom Collins

