home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / mobyop02.arj / MOBYOPUS.DOC < prev   
Text File  |  1991-03-02  |  8KB  |  205 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 MobyOpus
  10.  
  11.  
  12.                    AN INTERFACE FOR DSZ for OPUS CBCS
  13.  
  14.                         Written by Clinton LaRue
  15.                               Barn Owl BBS
  16.                                 1:108/165
  17.  
  18.  
  19.  
  20. MobyOpus is an interface that  calls Omen Technology's  DSZ program and
  21. makes  use of the  MobyTurbo feature which Omen has installed in recent
  22. releases of DSZ.  MobyOpus tries to determine what kind of data you are
  23. working with and helps DSZ select the best options for the transfer.
  24.  
  25.  
  26.  
  27.                                DISCLAIMER
  28.  
  29.  
  30.  
  31. This program is distributed on an "as is" basis.  The author assumes no
  32. responsibility for any problems or errors incurred with the use of this
  33. software.  By using this software, you are implying that you understand
  34. the above statement.
  35.  
  36. The files contained in this package are released free of charge and may
  37. be used under the above stipulations.
  38.  
  39. The  D)SZ-ZMOD  and  G)YMODEMG  interfaces have been tested extensively
  40. with Opus software and have been found to be relatively error free.  As
  41. with any new software,  problems may arise.   Please contact the author
  42. via NetMail should you discover any errors,   and every attempt will be
  43. made to correct them.
  44.  
  45.  
  46.         The Following Files Should Be Contained In This Package:
  47.                    DSZ-ZMOD.EXE  03/01/91 37015 bytes
  48.                    GYMODEMG.EXE  03/01/91 36999 bytes
  49.                    MOBYOPUS.DOC  This File
  50.  
  51.  
  52.        *     *      *      *      *      *      *      *      *      *
  53.  
  54.  
  55.                                 FEATURES
  56.  
  57.         1) Supports single or batch uploads and downloads in all Z Modem
  58.            forms.
  59.  
  60.         2) MobyOpus automatically calls for the  Compression  option if
  61.            the file being uploaded or downloaded has one of the follow-
  62.            ing extensions:
  63.                 .DOC .LST .LOG .TXT .ASM .BAT .MAP .REF .CTL .CFG
  64.            (If you come up with any other file types that are of a text
  65.            type let me know and I will add them to the internal table.)
  66.            The Compression option can  give significant improvements in
  67.            speed on text type files.
  68.  
  69.         3) If the file type isn't one of the above mentioned file types
  70.            MobyOpus  will automatically call for MobyTurbo compression.
  71.            This type of  compression gives you  improvements with  .ZIP
  72.            .ARC and other binary type files.
  73.  
  74.         4) If the Z Modem on the user's end does not support compression
  75.            or MobyTurbo then it will fall back to normal Z Modem!
  76.  
  77.         5) Unlike other external protocols, MobyOpus will write a log
  78.            file which Opus will use to  read and adjust user's upload
  79.            and download limits.
  80.  
  81.       * 6) The interfaces will now write directly to your BBS log file
  82.            showing the DSZ statistics.
  83.  
  84.  
  85.                               REQUIREMENTS
  86.  
  87.  
  88.  
  89.         1) You must have a registered copy of DSZ.  The reason for this
  90.            is because some of the  "registered only" features are being
  91.            used by this program.  This is not necessary from the user's
  92.            end.  DSZ can be registered from Omen Technology.  The order
  93.            forms, etc., are contained in the DSZ package.
  94.  
  95.         2) Your BBS and the user on the  other end must have a version
  96.            of DSZ that supports both the Compression and MobyTurbo op-
  97.            tions. I believe this support was included in the  02/18/90
  98.            and later versions of DSZ.
  99.  
  100.         3) If the user wishes to invoke MobyTurbo via DSZ, he must add
  101.            the  -m  switch to his DSZ command line.  Example:
  102.  
  103.                                DSZ rz -m
  104.                                DSZ sz -m
  105.  
  106.  
  107.  
  108.                               INSTALLATION
  109.  
  110.  
  111.  
  112.         1) You will need to add the following three SET  statements to
  113.            your AUTOEXEC.BAT file:
  114.  
  115.            SET DSZ-ZMOD=C:\OPUS\
  116.            SET GYMODEMG=C:\OPUS\
  117.            SET DSZLOG=C:\OPUS\DSZWORK.LOG
  118.  
  119.            The SET DSZ-ZMOD(GYMODEMG)=C:\OPUS tells the interface where
  120.            it will be called from. (Normally it will be located in your
  121.            Opus main directory.)
  122.  
  123.            The SET DSZLOG=C:\OPUS\DSZWORK.LOG tells DSZ to write a work
  124.            log file to the  Opus  main directory and instructs it to be
  125.            named DSZWORK.LOG.  (The DSZWORK.LOG name is cut in stone at
  126.            this time.)  This log handles both protocols.
  127.  
  128.         2) Add  the following statements to your  BBS.CTL  (or whatever
  129.            you call your control file) and re-compile (SALT) it;  or if
  130.            you use OPIE, edit line 19, then PEPPER and SALT it:
  131.  
  132.            EXTERNAL Protocol C:\OPUS\DSZ-ZMOD.EXE
  133.            EXTERNAL Protocol C:\OPUS\GYMODEMG.EXE
  134.  
  135.            This tells  Opus the name of the protocol and where it is to
  136.            be found.
  137.  
  138.         3) Put the DSZ-ZMOD.EXE and the GYMODEMG.EXE files in your Opus
  139.            main directory.
  140.  
  141.         4) Put the DSZ.EXE or DSZ.COM program (it doesn't matter which)
  142.            somewhere in your path  statement  so the interface can find
  143.            it.  (The DSZ.EXE {or .COM}  does not have to be in the Opus
  144.            main directory.)
  145.  
  146.  
  147. * Optional:  Occasionally, the interface may hang a system.  This appears
  148.     to be caused by the fossil driver and the interface not communicating
  149.     properly.  The following  procedure will rectify that problem.
  150.  
  151.            Create two files with a text editor in your Opus subdirectory,
  152.            one called  FOSSIL.REL and the other called  FOSSIL.CAP.   The
  153.            FOSSIL.REL file will contain statements that will  release the
  154.            fossil driver when MobyOpus is called.   Likewise,  FOSSIL.CAP
  155.            will re-capture the fossil upon termination of MobyOpus.  Here
  156.            are examples of each:
  157.  
  158.            <FOSSIL.REL>
  159.  
  160.             c:\bnu170\bnu /q      (Sample command line for BNU 1.70)
  161.             c:\x00\XU CAPTURE:OFF (Sample command line for X00 1.23)
  162.  
  163.             The  /q  tells the fossil driver to release itself from
  164.             the COM Port so that it doesn't interfere with DSZ.
  165.  
  166.            <FOSSIL.CAP>
  167.  
  168.             c:\bnu170\bnu /c      (Sample command line for BNU 1.70)
  169.             c:\x00\XU CAPTURE:ON  (Sample command line for X00 1.23)
  170.  
  171.             The  /c  tells the fossil driver to recapture the COM Port
  172.             so your BBS will run.  (WARNING:  FAILURE TO RECAPTURE THE
  173.             FOSSIL WILL RESULT IN A HUNG SYSTEM!)
  174.  
  175.   The FOSSIL.REL and FOSSIL.CAP are not mandatory. If you do not create
  176.   them, the interface will work just as it has in the past.
  177.  
  178.   NOTE:  The first time the external protocols are invoked by a user, a
  179.          "File Not Found" message will appear on your screen.  MobyOpus
  180.          is attempting to erase the DSZWORK.LOG file so Opus can adjust
  181.          the limits for the current user.  This message will not appear
  182.          again.
  183.  
  184.   That's it!  You should be up and running, and all in a matter of just
  185.   a few short minutes.
  186.  
  187. * = Release 2 in December, 1990.  Added Fossil release/capture feature.
  188.  
  189.  
  190.  
  191.                                  NOTES
  192.  
  193.  
  194. DSZ is a registered trademark of Omen Technology.
  195. OPUS is a registered trademark of Wynn Wagner III.
  196. LHARC is a registered trademark of Haruyasu Yoshizaki
  197.  
  198. The documentation was written and edited by Chuck Ammon of ANYTHING GOES
  199. BBS in Pittsburgh, PA.  129/112 in FidoNet.
  200.  
  201.  
  202.                               Clinton LaRue
  203.                               Barn Owl BBS
  204.                           1:108/165 in FidoNet
  205.