home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / bw311mx2.zip / BWMAIL.DOC < prev    next >
Text File  |  1995-12-01  |  124KB  |  2,572 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.        The Blue Wave Offline Mail Door for Maximus, Version 3.10
  18.        Copyright (C) 1992-1995 by Cutting Edge Computing
  19.        All Rights Reserved
  20.  
  21.        Configuration and Reference Manual
  22.        Written by George Hatchew
  23.  
  24.        Cutting Edge Computing
  25.        P.O. Box 90476
  26.        Burton, Michigan  49509-0476
  27.        USA
  28.  
  29.        BBS Support Number:  810-743-8464
  30.        FAX Support Number:  810-743-5910 (REGISTERED users only)
  31.        Voice Tech Support:  810-743-9283 (REGISTERED users only)
  32.  
  33.        Internet E-Mail   :  bluewave@cris.com
  34.        World Wide Web    :  http://www.cris.com/~bluewave
  35.  
  36.  
  37.  
  38.                                  TABLE OF CONTENTS
  39.                                  -----------------
  40.        Chapter 1
  41.            ABOUT THIS DOCUMENTATION                               3
  42.        Section 1.1  Purpose of this Documentation                 3
  43.        Section 1.2  Printing this Documentation                   4
  44.        Chapter 2
  45.            LICENSING AND DISTRIBUTION                             5
  46.        Section 2.1  Software License Agreement                    5
  47.        Section 2.2  Purchasing a License                          6
  48.        Section 2.3  Corporate and Governmental Purchase Orders    8
  49.        Section 2.4  What You Receive When You Order               8
  50.        Section 2.5  Registered User License                       9
  51.        Section 2.6  Trademarks and Credits                        9
  52.        Chapter 3
  53.            ABOUT THE BLUE WAVE MAIL DOOR                         11
  54.        Section 3.1  History of Offline Mail Systems              11
  55.        Section 3.2  What Are E-Mail Networks For?                12
  56.        Section 3.3  What Features are in Blue Wave?              12
  57.        Chapter 4
  58.            HARDWARE AND SOFTWARE REQUIREMENTS                    14
  59.        Section 4.1  Different Blue Wave Mail Door Versions       14
  60.        Section 4.1.1  Requirements for The Blue Wave Mail Door   14
  61.        Section 4.2  Different Blue Wave Reader Versions          15
  62.        Section 4.2.1  Requirements for Blue Wave/DOS             15
  63.        Section 4.2.2  Requirements for Blue Wave/386             16
  64.        Section 4.2.3  Requirements for Blue Wave/OS2             17
  65.        Section 4.3  Locating Other Blue Wave Versions            17
  66.        Section 4.4  Required External Programs                   18
  67.        Section 4.5  MS-DOS CONFIG.SYS Settings                   18
  68.        Chapter 5
  69.            INSTALLING THE MAIL DOOR INTO MAXIMUS                 20
  70.        Section 5.1  Mail Door Installation                       20
  71.        Section 5.2  Maximus Menu and Message Area Setup          21
  72.        Section 5.3  BWMAIL Command Line Parameters               23
  73.        Section 5.4  Multi-Node Installation Considerations       28
  74.        Section 5.5  Supported Maximus Features                   29
  75.        Chapter 6
  76.            INSTALLING EXTERNAL PROGRAMS                          31
  77.        Section 6.1  Installing External Support Programs         31
  78.        Section 6.2  The PATH Environment Variable                31
  79.        Section 6.3  Configuring External Archiver Programs       32
  80.        Section 6.3.1  Macros Used for Archiver Definitions       33
  81.        Section 6.3.2  Sample Archiver Command Lines              34
  82.        Section 6.3.3  Notes About Archiver Command Lines         35
  83.        Chapter 7
  84.            OPERATING THE MAIL DOOR                               36
  85.        Section 7.1  General Mail Door Operation                  36
  86.        Section 7.2  Functions Available While a User is Online   36
  87.        Section 7.3  Maintaining The Blue Wave Mail Door          38
  88.        Section 7.3.1  Message Area Overrides                     38
  89.        Section 7.3.2  Removing Old User Records                  39
  90.        Section 7.4  Creating and Using Reader Bulletin Files     39
  91.        Section 7.5  Using the Mail Door in Local Mode            40
  92.        Section 7.6  The FidoNet->Internet Gateway                42
  93.        Chapter 8
  94.            SOFTWARE SUPPORT INFORMATION                          43
  95.  
  96.  
  97.                                          ------------------------------------
  98.                                          Chapter 1:  ABOUT THIS DOCUMENTATION
  99.                                          ------------------------------------
  100.  
  101.  
  102.        Section 1.1  Purpose of this Documentation
  103.  
  104.        The documentation presented in this file is designed to:
  105.  
  106.        * Provide an overview of the operation of The Blue Wave Offline Mail
  107.          Door from the SysOp or System Adminstrator's point of view, and the
  108.          concept of offline mail systems in general.
  109.  
  110.        * Provide information about the minimal system hardware configuration
  111.          that is required to use the mail door.
  112.  
  113.        * Provide details about the external programs which are required for
  114.          proper usage of the mail door, including the configuration of
  115.          these external programs.
  116.  
  117.        * Describe the features available in the mail door, and how to use
  118.          them effectively.
  119.  
  120.        The documentation  in this  file is  not meant as a reference for end-
  121.        users of  The Blue  Wave Offline  Mail Door.  A separate documentation
  122.        file describing  the use  of the  mail door  for  end-users  has  been
  123.        included in  a file  called BWDOOR.DOC.  The information in BWDOOR.DOC
  124.        applies to  all Blue Wave Mail Doors -- it is not specific to the mail
  125.        door for any single BBS software package.
  126.  
  127.        The mail door's configuration program (BWSETUP.EXE) provides an online
  128.        help system  which describes  each configuration  field in detail.  At
  129.        any point while using BWSETUP you can press the <F1> key for immediate
  130.        on-screen context sensitive help.
  131.  
  132.        If at any time you need help while using the mail door's configuration
  133.        utility, always  remember that documentation is only an <F1> key press
  134.        away.   The online  help system  provides 'hot  links' to related help
  135.        topics, and a help topic index to allow you to find items of interest.
  136.        In addition, each error message and condition that is generated by the
  137.        configuration utility  is covered  by an online help category.  If you
  138.        receive an  error message or condition while using BWSETUP, and you do
  139.        not know the cause of the problem, the help system will most likely be
  140.        able to  give you specific information about the cause and how you can
  141.        go about fixing it.
  142.  
  143.        This documentation  provides a Table of Contents; use this to help you
  144.        locate items  of interest in this file, or use a file viewer/editor to
  145.        search for items you may be looking for.
  146.  
  147.        Instructions for  printing this documentation file can be found in the
  148.        following section.
  149.  
  150.  
  151.  
  152.                  --------------------------------------------------
  153.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 3
  154.  
  155.  
  156.        Section 1.2  Printing this Documentation
  157.  
  158.        This documentation  is formatted  with Form  Feeds for printing on all
  159.        Personal Computer  printers.   This documentation file contains no IBM
  160.        Extended ASCII  characters, so  it should  print fine  on all  printer
  161.        models - even non IBM ProPrinter compatibles.
  162.  
  163.        To print this documentation in hard copy, simply execute the following
  164.        command from the DOS (or OS/2) command line:
  165.  
  166.             COPY BWMAIL.DOC PRN
  167.  
  168.        If you  would like  to print  this documentation  using the  PRINT.COM
  169.        print spooler  provided with most versions of DOS, simply execute this
  170.        command at the DOS prompt:
  171.  
  172.             PRINT BWMAIL.DOC
  173.  
  174.        OS/2 users  note that  PRINT.COM is  not necessary under OS/2, as OS/2
  175.        has an  internal print  spooler.  Simply type "COPY BWMAIL.DOC PRN" if
  176.        you are an OS/2 user.
  177.  
  178.        The documentation  is formatted  to 60 lines per page so that printing
  179.        on laser  printers should  also work  with no  problems.  If, when you
  180.        attempt to  print this  documentation, your  printer  begins  ejecting
  181.        pages which  are not complete (the page number is not at the bottom of
  182.        the page),  you should cancel the print job and configure your printer
  183.        to accept  at least  60 lines per page.  You will need to consult your
  184.        printer's user manual for information on how this can be done.
  185.  
  186.        The documentation was written by George Hatchew and is Copyright (C)
  187.        1995 by Cutting Edge Computing.  It may be distributed freely, so long
  188.        as it is kept together with the entire set of mail door files.  Please
  189.        read  the   section  titled  "Software  License  Agreement"  for  more
  190.        information.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.                  --------------------------------------------------
  212.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 4
  213.  
  214.  
  215.  
  216.                                        --------------------------------------
  217.                                        Chapter 2:  LICENSING AND DISTRIBUTION
  218.                                        --------------------------------------
  219.  
  220.  
  221.        Section 2.1  Software License Agreement
  222.  
  223.        Cutting Edge  Computing has  taken every  precaution to ensure that no
  224.        harm or  damage will  occur to  systems running  The Blue Wave Offline
  225.        Mail System.   However,  we cannot  be responsible  for any damages or
  226.        other losses  sustained as  a result  of running this software on your
  227.        system.   The user  assumes full  responsibility for the proper use of
  228.        this mail  system, whether  damage occurs as a fault of operator error
  229.        or software error.  NO WARRANTIES ARE IMPLIED OR EXPRESSLY STATED.
  230.  
  231.        The Blue  Wave Mail  System and  this  documentation  are  copyrighted
  232.        materials of  Cutting Edge Computing and George Hatchew.  Cutting Edge
  233.        Computing reserves  all rights  to these  materials, and  is protected
  234.        under United  States and  International Copyright  laws.   No part  of
  235.        these materials  may be  reproduced or modified in any way without the
  236.        prior express written permission of Cutting Edge Computing.
  237.  
  238.        Use of The Blue Wave Offline Mail System constitutes acceptance of the
  239.        stated terms  and conditions.   Cutting  Edge Computing  reserves  all
  240.        rights which are not expressly granted.
  241.  
  242.        The Blue  Wave Offline  Mail System  is fully copyrighted, and is not,
  243.        nor will it ever be, in the Public Domain.  The Blue Wave Offline Mail
  244.        System is  NOT FreeWare.   It  is distributed  and marketed  under the
  245.        concept of  ShareWare.   Users are  allowed to try this program for 30
  246.        days before  paying for  and registering  the mail system with Cutting
  247.        Edge Computing.   In this 30 days, you may use the program to its full
  248.        capacity.   If the  software does  not meet your needs, and you do not
  249.        plan on  purchasing and  registering this  software with  Cutting Edge
  250.        Computing after  your 30  day trial  period, you are to cease usage of
  251.        the mail  system.   Continued use  beyond  the  authorized  evaluation
  252.        period is  a violation  of copyright  law unless  you have  payed  the
  253.        registration fee in full.
  254.  
  255.        Cutting Edge  Computing  grants  an  unlimited  license  to  make  and
  256.        distribute UNREGISTERED  copies of  The Blue  Wave Offline Mail System
  257.        which have  been released  to the  public by  Cutting Edge  Computing.
  258.        Absolutely no  modifications to  the files  contained in  the software
  259.        package,  including  this  documentation  file,  may  be  made  before
  260.        distribution.  No fee may be charged by anyone other than Cutting Edge
  261.        Computing beyond the actual cost of providing these copies without the
  262.        prior written consent of Cutting Edge Computing.
  263.  
  264.        Distribution on CD-ROM, BBS systems, and other media is encouraged, so
  265.        long as the purchaser of the CD-ROM (and other media) or downloader of
  266.        the software  is aware  that they  must also purchase a LICENSE to use
  267.        this software.   The  purchase price  of the media or any subscription
  268.        costs to an online service do not pay for this license.
  269.  
  270.                  --------------------------------------------------
  271.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 5
  272.  
  273.        Section 2.2  Purchasing a License
  274.  
  275.        There are  several ways  in which  you  can  purchase  a  license  (or
  276.        register) to  use this  software.   Methods for  registration  include
  277.        surface mail, FAX registrations by credit card, and online credit card
  278.        registrations through our support BBS.
  279.  
  280.        When you  unpacked the  mail door and this documentation file from the
  281.        distribution archive,  three registration  forms should have also been
  282.        unpacked.   The main registration form is called REGISTER.BW.  This is
  283.        a text file which can be printed in the same manner as described above
  284.        for printing  this documentation.   Two other forms are also included.
  285.        REGISTER.AUS can  be used  to register  the software  if you  live  in
  286.        Australia, New  Zealand, Singapore,  or any other nearby country.  Our
  287.        registration agent  in Australia  is  Craig  Gibson  (Fidonet  address
  288.        3:620/252).   REGISTER.EUR can be used to register the software if you
  289.        live anywhere  in Europe.   Our  registration agent in Europe is Steve
  290.        Stacher (2:443/888).
  291.  
  292.        To register  by  surface  mail,  simply  print  the  appropriate  form
  293.        (REGISTER.AUS for  Australia and  nearby  countries,  REGISTER.EUR  in
  294.        Europe, and  REGISTER.BW elsewhere in the world).  Complete all of the
  295.        necessary information  and mail  the form  to the address shown on the
  296.        form.
  297.  
  298.        To register  by FAX,  you must  use a  credit card.   We  accept Visa,
  299.        MasterCard, Discover, American Express, Diner's Club, Optima, and JCB.
  300.        Complete the  form REGISTER.BW  and FAX  the form  to +1-810-743-5910.
  301.        Sorry, FAX  orders cannot  be accepted  at the Australian registration
  302.        agent.
  303.  
  304.        To register  through our support BBS, use a communications program and
  305.        your modem  to dial  +1-810-743-8464.   You must  be using  one of our
  306.        accepted credit  cards (Visa,  MasterCard, Discover, American Express,
  307.        Diner's Club,  Optima, or JCB).  When you log into the support BBS and
  308.        reach the  Main Menu, simply type 'R' to load the Registration System.
  309.        If your credit card authorization request is accepted by the bank, you
  310.        will immediately be provided a 'temporary' 30-day registration number.
  311.        After final  approval of  your credit  card order,  you will receive a
  312.        permanent registration  number via  surface  mail  (approximately  1-2
  313.        weeks).
  314.  
  315.        We perform  address verification on all credit card orders by phone or
  316.        through our  online registration  system.   If the address information
  317.        you provide  is not  accurate, our bank will decline the authorization
  318.        on your credit card.
  319.  
  320.        To register  by check  or money order, simply fill out the appropriate
  321.        registration form  and mail  it to  the address shown.  All checks and
  322.        money orders  MUST be payable in United States currency, and they MUST
  323.        be drawn  on a  US  bank.    EuroCheques  and  GiroCheques  cannot  be
  324.        accepted.   Due to  the fees our bank charges for cashing checks drawn
  325.        on a  Canadian bank,  we must  require that  you enclose an additional
  326.        $15.00 US  if you pay with a check from a Canadian bank.  We suggest a
  327.  
  328.  
  329.                  --------------------------------------------------
  330.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 6
  331.  
  332.        Postal Money  Order, available  from your  local post office, instead.
  333.        This is a much cheaper alternative.
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.                  --------------------------------------------------
  389.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 7
  390.  
  391.        Section 2.3  Corporate and Governmental Purchase Orders
  392.  
  393.        Purchase orders  from large corporations and governmental agencies are
  394.        accepted with  "NET 30"  terms.    Both  site  licenses  and  per-copy
  395.        licenses are  available.   Please write to Cutting Edge Computing with
  396.        your requirements and we will submit a bid.  Site license and per-copy
  397.        discounts apply  when 25  or more copies of The Blue Wave Offline Mail
  398.        Reader and/or Blue Wave Offline Mail Door are purchased at one time.
  399.  
  400.        Our mailing address is:
  401.  
  402.        Cutting Edge Computing
  403.        P.O. Box 90476
  404.        Burton, MI  48509-0476  USA
  405.  
  406.  
  407.        Section 2.4  What You Receive When You Order
  408.  
  409.        When you  purchase a copy of The Blue Wave Offline Mail Door, you will
  410.        receive a  registration letter  which contains  details on  converting
  411.        your evaluation  copy of the mail door into a registered version.  The
  412.        registration letter  will assign you a unique user registration number
  413.        based upon  the SysOp name, and mail packet name you supplied when you
  414.        submitted your  registration form.   To  convert your copy of the mail
  415.        door into  a fully  licensed version,  you simply  need to  enter  the
  416.        registration name,  mail packet name, and registration number supplied
  417.        into the  "General Information"  section of  the BWSETUP program.  The
  418.        next time  you load  the  mail  door,  it  will  recognize  you  as  a
  419.        registered owner of the software.
  420.  
  421.        In order  to keep registration costs low, we do not automatically ship
  422.        a disk  containing a  copy of  the software.  Since you already HAVE a
  423.        copy of  the software,  we can  simply provide you with a registration
  424.        number to  activate the software license.  If you would like to insure
  425.        that you  have the latest version of the mail door, we do offer a disk
  426.        mailing service for an additional $5.00US.
  427.  
  428.        Sorry, we  currently do  not offer a printed manual for the mail door.
  429.        With the  online documentation/help  system built  into the  mail door
  430.        configuration utility, we have found that most users do not need or do
  431.        not want to pay the extra cost of providing a printed manual.
  432.  
  433.        Please be  sure to  keep the  registration letter you receive from us.
  434.        You may  need your  registration number  handy in  the case  of a disk
  435.        failure or  other system  crash.  This registration letter also serves
  436.        as your official software license.
  437.  
  438.        If  you   lose  or   otherwise  misplace  your  software  registration
  439.        certificate, we  can provide  you with  a replacement  copy.  You must
  440.        send your  request to our mailing address along with a self-addressed,
  441.        STAMPED envelope.  (Users outside of the United States must enclose an
  442.        International  Reply   Coupon,  available   at  your   post   office).
  443.        Replacement registration  codes will  NOT be  given by any other means
  444.        (FAX, e-mail, or voice technical support).
  445.  
  446.  
  447.                  --------------------------------------------------
  448.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 8
  449.  
  450.  
  451.        Section 2.5  Registered User License
  452.  
  453.        Registered users  of The  Blue Wave Offline Mail System are granted an
  454.        unlimited license to use the product, provided the following:
  455.  
  456.        *  Registration fees are NOT refundable.
  457.  
  458.        *  Registration codes are not transferable to other parties.
  459.  
  460.        *  Unofficial software patches must not be applied, and all copyright
  461.           notices in the documentation and supporting files are not to be
  462.           altered.
  463.  
  464.        *  Backup copies may be kept of all registered versions of this
  465.           software for archive purposes only.
  466.  
  467.        *  Use of a registered copy is limited to one machine at a time.  Use
  468.           of multiple registered copies on multiple machines AT THE SAME TIME
  469.           requires additional payment to Cutting Edge Computing.
  470.  
  471.  
  472.        Section 2.6  Trademarks and Credits
  473.  
  474.        Cutting Edge  Computing would like to thank all users of The Blue Wave
  475.        Offline Mail System for their outstanding contributions in the form of
  476.        new feature  requests, advice,  and word-of-mouth recommendations.  It
  477.        is users of the mail system that have made it what it is today.
  478.  
  479.        Cutting Edge  Computing extends credit to Scott J. Dudley for his work
  480.        in creating  the Squish  Message Base  Format and  the Squish  MSGAPI,
  481.        which is used in the code of The Blue Wave Mail Door in versions which
  482.        support the Squish Message Base Format.
  483.  
  484.        Cutting Edge  Computing extends credit to Joaquim Homrighausen, Andrew
  485.        Milner, Mats Birch, and Mats Wallin for their work in creating the JAM
  486.        message base  and the  JAM(mbp) API,  which is used in the code of The
  487.        Blue Wave  Mail Door  in versions  which support  the JAM Message Base
  488.        Format.
  489.  
  490.        The use  of these  APIs (Application  Programmer's Interfaces) ensures
  491.        maximum compatibility with the supported message base formats.
  492.  
  493.        Cutting Edge Computing would also like the thank all past  and current
  494.        software testers  for their  tireless and  extensive work in providing
  495.        problem reports and suggestions during the testing process.
  496.  
  497.        The following  products are  mentioned throughout  this documentation.
  498.        They are  products or  trademarks  of  the  companies  or  individuals
  499.        indicated:
  500.  
  501.             AMD                 Advanced Micro Devices
  502.             ARJ                 Robert Jung
  503.             Cyrix               Cyrix Corporation
  504.             DESQview            Quarterdeck Office Systems
  505.  
  506.                  --------------------------------------------------
  507.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 9
  508.  
  509.             FidoNet             Tom Jennings, Fido Software
  510.             IBM OS/2, PC-DOS    International Business Machines Corporation
  511.             Intel               Intel Corporation
  512.             Maximus             Scott Dudley, Lanius Corporation
  513.             MS-DOS, Windows     Microsoft Corporation
  514.             Opus-CBCS           Wynn Wagner, III
  515.             PCBoard             Clark Development
  516.             PKZIP/PKUNZIP       PKWARE, Incorporated
  517.             ProBoard            Philippe Leybaert
  518.             QuickBBS            Pegasus Software
  519.             RemoteAccess        Wantree Development
  520.             SuperBBS            Risto Virkkala and Aki Antman
  521.             T.A.G.              The T.A.G. Team
  522.             Telegard            Tim Strike
  523.             WildCat!            Mustang Development Corporation
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.                  --------------------------------------------------
  566.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 10
  567.  
  568.  
  569.  
  570.                                     -----------------------------------------
  571.                                     Chapter 3:  ABOUT THE BLUE WAVE MAIL DOOR
  572.                                     -----------------------------------------
  573.  
  574.  
  575.        Section 3.1  History of Offline Mail Systems
  576.  
  577.        Back in  the early  to mid  1980's, many  people were beginning to get
  578.        home computers and modems.  People began communicating in several ways
  579.        through Bulletin  Board Systems  (BBS's).   BBS systems began offering
  580.        message bases where people of similar interests could communicate with
  581.        each other  through electronic  means.  As the technology grew, people
  582.        started sharing message bases between different BBS systems across the
  583.        city, then  across the country, and eventually across the world.  Mail
  584.        conferencing was born, and nothing was going to stop it.
  585.  
  586.        At about  the same  time, commercial online services began offering E-
  587.        Mail services  which could  transmit a  message to a recipient several
  588.        thousands of  miles away  in a  matter  of  hours,  minutes,  or  even
  589.        seconds.   In the  early  stages,  however,  these  commercial  online
  590.        services were  very expensive.  E-Mail on commercial services normally
  591.        could only  be afforded  by businesses  and a  handful of individuals.
  592.        Many people became hooked, many others dependant, on E-Mail.
  593.  
  594.        While the  commercial companies  were developing new, faster, and less
  595.        expensive ways  to transmit  E-Mail across  the  world,  so  were  the
  596.        amateur  BBS   operators.     Several  amateur   E-Mail  networks  and
  597.        technologies were  formed.  One of the largest amateur E-Mail networks
  598.        still popular today is FidoNet.
  599.  
  600.        Don't let  the term  'amateur' fool  you.  Many of the people that are
  601.        responsible for  keeping FidoNet  up and  running may be classified as
  602.        amateurs, but years of experience and knowledge, and usually thousands
  603.        of dollars in equipment, have earned them a very respectable name.
  604.  
  605.        Today, FidoNet  is nearly  20,000 nodes  strong and still growing!  As
  606.        the networks  and the number of home computer users has grown, the use
  607.        of technology  for reading  and replying  to E-Mail offline has become
  608.        more and  more essential.   When BBSing was young, there was plenty of
  609.        time to  read and  reply to  messages online.   Today, with more users
  610.        than ever  and more E-Mail flowing than ever, there just is not enough
  611.        time for  every user  to spend a half-hour, an hour, or even two hours
  612.        online to  their local BBS.  Long distance phone rates can also get to
  613.        be outrageously  expensive after  just a  few of  these  sessions  per
  614.        month.
  615.  
  616.        This is  where offline  mail reading  comes into  play.   With today's
  617.        innovations in  offline mail  processing, your  users can spend just a
  618.        very few minutes per day online to your BBS system and do all of their
  619.        work OFFLINE,  where there  is no system time limit to run up against,
  620.        and where  the phone  company's meter is not running.  This also frees
  621.        up your  system phone  line(s) for  access  by  more  users  and  help
  622.        alleviate the dreaded 'busy signals'.
  623.  
  624.                  --------------------------------------------------
  625.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 11
  626.  
  627.  
  628.        Best of all, users can read their mail at any time of the day or night
  629.        -- whenever  they have  free time.   Today's  communications  software
  630.        allows users  to build "smart" script files, which in turn allows them
  631.        to retrieve  their mail  automatically at even the oddest times of the
  632.        day or night (especially when long distance phone rates are low).
  633.  
  634.  
  635.        Section 3.2  What Are E-Mail Networks For?
  636.  
  637.        At this  point, you  may be  asking yourself, "What exactly are E-Mail
  638.        Networks for?".   Some people unfamiliar with mail networks and E-Mail
  639.        sometimes cannot  understand the enjoyment and knowledge that can come
  640.        out of being an active participant on an E-Mail network.  Not only can
  641.        you communicate with people from all corners of the world, but you can
  642.        learn more  about your  favorite computer software, share recipes with
  643.        others, learn  how to repair your leaking roof, get advice from others
  644.        on product  quality ratings,  or just  join in  a  chat  between  long
  645.        distance friends.  As a matter of fact, FidoNet alone offers well over
  646.        300 E-Mail  topics (sometimes called 'echos' or 'conferences') ranging
  647.        from Aardvarks to Zymurgy.
  648.  
  649.        Many businesses  now use  internal E-Mail  networks for communications
  650.        between employees  just down  the hall,  across town, or even half-way
  651.        around the  globe.   Many software and computer hardware companies now
  652.        have a support BBS which allows users to dial in and exchange messages
  653.        and files  between users.   Technical support is nearly always offered
  654.        through these types of support systems.
  655.  
  656.        If your  system is  not currently  part of  an E-Mail  network,  don't
  657.        worry.   The Blue Wave Offline Mail System will still provide you with
  658.        all of the features described.  And, if you later decide to join an E-
  659.        Mail network, you will already have The Blue Wave Offline Mail Door up
  660.        and running.  Very few, if any, changes will be necessary to integrate
  661.        the offline mail system into your E-Mail network.
  662.  
  663.  
  664.        Section 3.3  What Features are in Blue Wave?
  665.  
  666.        The Blue  Wave Offline  Mail Door  is unlike many offline mail systems
  667.        available today.
  668.  
  669.        The Blue  Wave Mail Door is tightly integrated with your BBS software.
  670.        This allows  the mail  door to have the same security features as your
  671.        BBS and  interface directly  with your  BBS's data  files.  This means
  672.        that The Blue Wave Mail Door requires very little to no maintenance by
  673.        the SysOp; just "plug it in and forget about it!"
  674.  
  675.        The mail  door allows  you to set default message areas for new users,
  676.        and force message areas on for all users or individual users.  Message
  677.        areas can  be blocked  on a  user-by-user basis, allowing your greater
  678.        control and  flexibility in  managing access to specific message areas
  679.        on your system.
  680.  
  681.  
  682.  
  683.                  --------------------------------------------------
  684.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 12
  685.  
  686.        Full compatibility  with FidoNet EchoMail and NetMail message areas is
  687.        one of  the greatest features of the mail system.  If you are a member
  688.        of a  FidoNet-style network,  the mail  door offers full plug and play
  689.        compliance with  FidoNet standards.   Those BBS systems that support a
  690.        direct interface  for Internet  E-Mail and  Usenet Newsgroups are also
  691.        supported directly by The Blue Wave Mail Door.
  692.  
  693.        The Blue  Wave Mail  System offers a unique user Offline Configuration
  694.        system.   While the  user is using a Blue Wave-compatible mail reader,
  695.        they can  configure all  aspects of  the mail  door's  behavior  while
  696.        offline.   When the user uploads the offline configuration information
  697.        to the  mail door, the door automatically adjusts itself to the user's
  698.        new configuration  settings.  There is absolutely no setup required to
  699.        enable this feature.
  700.  
  701.        File Requesting is another option available to a user.  While offline,
  702.        a user may input a list of files that they would like to download from
  703.        your system.   The  next time  they use  the mail door to upload their
  704.        mail packet,  the door  automatically senses  the request for specific
  705.        files and  will send  them to  the user  as part  of their  next  mail
  706.        packet.   Full  record  checking  is  performed  during  file  request
  707.        sessions, including file access security, time limits, download:upload
  708.        ratios, and  any other  BBS-specific file  download options.   You can
  709.        control the  number of files that may be requested during one session,
  710.        or you may disable the file requesting feature entirely.
  711.  
  712.        As a  complement to  the file  requesting feature,  the mail door will
  713.        also perform  "new file  scanning."   If you  enable the new file scan
  714.        feature, users  will be  able to  choose the option of including a new
  715.        file listing  since their last mail download, or skipping the new file
  716.        scan altogether.
  717.  
  718.        One of  the more powerful features available to users is the Blue Wave
  719.        Bundling Commands.   Bundling  commands  allow  users  to  selectively
  720.        include, exclude,  and manipulate  the messages that are packed before
  721.        they actually  perform a mail download.  Please see the mail door user
  722.        documentation (BWDOOR.DOC)  for more  information about  this and many
  723.        other features available to users.
  724.  
  725.        The Blue  Wave Mail  Door is  one of  the  most  exciting  and  useful
  726.        utilities that you can add to your BBS.  It provides many benefits for
  727.        both SysOps  and users  alike.  After a while, you will wonder how you
  728.        ever managed without it!
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.                  --------------------------------------------------
  743.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 13
  744.  
  745.  
  746.  
  747.                                ----------------------------------------------
  748.                                Chapter 4:  HARDWARE AND SOFTWARE REQUIREMENTS
  749.                                ----------------------------------------------
  750.  
  751.  
  752.        Section 4.1  Different Blue Wave Mail Door Versions
  753.  
  754.        The Blue  Wave Offline  Mail Door  is available  in several  different
  755.        versions.  You should select the version that corresponds with the BBS
  756.        software that  you are  running.   Because each Blue Wave Mail Door is
  757.        more like  an extension  to your  BBS software,  rather than  just  an
  758.        external message  processing facility, it is vital that you select the
  759.        correct mail door to run on your system.
  760.  
  761.        It is  unlikely that  you will  be able  to use  a Blue Wave Mail Door
  762.        intended for  one specific  BBS  software  with  another  similar  BBS
  763.        software.   For example,  if you  are  running  SuperBBS,  it  is  not
  764.        possible to  run the  QuickBBS mail  door with  your software  -- even
  765.        though the  two BBS  software packages  are extremely  similar in both
  766.        operation and data file formats.
  767.  
  768.        At the  time this documentation was written, Blue Wave Mail Doors were
  769.        available for the following BBS software packages:
  770.  
  771.             * Maximus (DOS and OS/2)
  772.             * Opus
  773.             * ProBoard
  774.             * QuickBBS
  775.             * RemoteAccess
  776.             * SuperBBS
  777.             * T.A.G.
  778.             * Telegard
  779.  
  780.        In addition,  a Blue  Wave Mail  Door for  PCBoard (both  DOS and OS/2
  781.        versions) was  in development,  and was  scheduled to  be available in
  782.        early 1996.   A  WildCat! compatible  mail door was scheduled to begin
  783.        development in early 1996.
  784.  
  785.        If you  would like  to obtain  any of these mail door versions, please
  786.        see Section  4.3 (Locating  Other Blue  Wave Versions)  for additional
  787.        information.
  788.  
  789.  
  790.        Section 4.1.1  Requirements for The Blue Wave Mail Door
  791.  
  792.        The Blue  Wave Mail  Door is  one of  the most  versatile  mail  doors
  793.        available.  The mail door will run on any IBM-PC Compatible computer--
  794.        whether it  be an XT or the latest Intel Compatible Processor.  At the
  795.        time of  this  writing,  the  Pentium  was  the  latest  Intel  system
  796.        available, with  the Pentium Pro waiting in the wings.  Of course, the
  797.        mail door  will also  run on  Intel Compatible chips such as the Cyrix
  798.        and AMD offerings.
  799.  
  800.  
  801.                  --------------------------------------------------
  802.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 14
  803.  
  804.        The mail door will require approximately 200-300K of available memory.
  805.        The actual amount of memory required varies with the number of message
  806.        areas that are configured on your system.
  807.  
  808.        You will also need some hard disk space available.  The amount of hard
  809.        disk space varies greatly from system to system and from user to user.
  810.        While the  mail door  packs messages  into a  mail packet  for a user,
  811.        there will  need to  be enough  drive  space  available  to  hold  the
  812.        temporary files.   It  is unlikely  that you  will ever  need over  10
  813.        megabytes of  free disk  space available  for  temporary  files.    An
  814.        estimate in  the 2-3 megabyte range would not be far off target.  With
  815.        the mail  door's built-in  session limits  (see BWSETUP's  "Limits for
  816.        Mail Sessions"  menu option), you can control how many messages a user
  817.        may pack in any single mail session.  This will allow you to fine-tune
  818.        or limit the drive space that may be necessary at any one time.
  819.  
  820.        If you are running the OS/2 version of one of our mail doors, the same
  821.        requirements for  memory and disk space apply.  However, you will need
  822.        a system  capable of  running IBM  OS/2 v2.0  or higher.  This implies
  823.        that you  need at least an 80386SX processor with at least 4 megabytes
  824.        of memory.
  825.  
  826.  
  827.        Section 4.2  Different Blue Wave Reader Versions
  828.  
  829.        The Blue  Wave  Offline  Mail  Reader  v2.20  is  available  in  three
  830.        different versions.   There  is Blue Wave/DOS, Blue Wave/386, and Blue
  831.        Wave/OS2.   Each  mail  reader  has  the  same  set  of  features  and
  832.        operations available.   They  differ only in the operating system they
  833.        require, and  the amount of data they can handle.  (The amount of data
  834.        they can  handle is related to the operating system they are being run
  835.        under).
  836.  
  837.        The hardware  and  software  requirements  of  each  version  will  be
  838.        explained in  the following  three sections.    You  should  read  the
  839.        requirements for  each of  the three  different versions  of the  mail
  840.        reader to  be sure  that you  use the one that is most appropriate for
  841.        your system and your needs.
  842.  
  843.  
  844.        Section 4.2.1  Requirements for Blue Wave/DOS
  845.  
  846.        The Blue  Wave Offline  Mail Reader for DOS is by far the most popular
  847.        version of  the mail  reader.   It can  be  run  on  any  100%  IBM-PC
  848.        compatible computer  that runs  PC-DOS, MS-DOS,  or Novell DOS version
  849.        3.0 or  higher.   This includes  DOS emulation  in both  IBM OS/2  and
  850.        Microsoft Windows.  A minimum 1MB of free disk space is also needed.
  851.  
  852.        This software  will run  efficiently  on  any  Intel  8088  compatible
  853.        processor, which  includes the  IBM PC/XT,  IBM PC/AT, any Intel 80286
  854.        compatible processor, and processors compatible with the 80386, 80486,
  855.        and the Intel Pentium (such as an AMD or Cyrix processor).
  856.  
  857.        This version of the mail reader requires at least 300K of free memory,
  858.        and does not require the use of Expanded or Extended memory.  However,
  859.  
  860.                  --------------------------------------------------
  861.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 15
  862.  
  863.        due to  the limitation  of the  DOS operating system, this mail reader
  864.        cannot make  use of  any more than 640K of memory.  This limitation is
  865.        apparent in all DOS-based programs that operate in 'real' mode.  (Real
  866.        mode is a technical term that you probably do not have to worry about.
  867.        It is a term that, if you know what it means, you wish you didn't!).
  868.  
  869.        Because of  the limitations  of DOS  (the operating  system), the mail
  870.        reader is constrained to the limit of 640K of base memory.  This means
  871.        that, even though you may have 8 megabytes of memory in your computer,
  872.        DOS programs will only 'see' the first 640K.  This puts a limit on the
  873.        number of  message areas  and the number of messages per area that the
  874.        reader can  handle.   If you  are running an 80386 processor or higher
  875.        along with DOS or Windows, you may want to try the version of the mail
  876.        reader called  "Blue Wave/386".   Blue  Wave/386 can  'see' all of the
  877.        memory in  your computer  and use  it for  loading  large  numbers  of
  878.        messages and  message  areas,  in  addition  to  very  large  messages
  879.        (commonly encountered on the global Internet and USENET networks).
  880.  
  881.  
  882.        Section 4.2.2  Requirements for Blue Wave/386
  883.  
  884.        Blue Wave/386  is an extended, or protected mode DOS program.  In very
  885.        simple terms,  this means that it is capable of utilitizing all memory
  886.        that is  installed on  your system.  (Please read the previous section
  887.        for more  information).   In addition to the ability to use all memory
  888.        in your computer, Blue Wave/386 can also 'simulate' memory through the
  889.        use of a disk file.  This is sometimes called a 'swap file' or Virtual
  890.        Memory.
  891.  
  892.        In order  to run Blue Wave/386 on your system, you must be running DOS
  893.        4.0 or  higher, OS/2  v2.0 or  higher, or  Windows v3.0 or higher.  In
  894.        addition, your computer processor must be at least an Intel compatible
  895.        80386, 80486,  or Pentium.   This  version of  the  mail  reader  also
  896.        requires more disk space than the rest.  A minimum of 2MB of free disk
  897.        space (more if a swap file is used) is needed.
  898.  
  899.        You must  also have  at least  1MB of  free memory  available on  your
  900.        system.   2MB of free memory is recommended for the fastest operation.
  901.        Through the  use of  both RAM  and swap  space (Virtual  Memory), Blue
  902.        Wave/386 can load thousands of message areas, thousands of messages in
  903.        an area,  and messages that are several megabytes long without batting
  904.        an eye.   Again, the only limit to Blue Wave/386 is the amount of real
  905.        memory plus  the amount of disk space you can give it.  It will handle
  906.        any mail packets you give it now and well into the future.
  907.  
  908.        For the technical wizards;  Blue Wave/386 will use a DPMI server, XMS,
  909.        EMS, or  VCPI interface to upper memory.  A DPMI server is recommended
  910.        (OS/2, Windows, and QEMM provide DPMI services).
  911.  
  912.        This version  is NOT  recommended if  you are running OS/2.  Protected
  913.        mode switching  in this mail reader will consume an undesirable amount
  914.        of processor  time.   OS/2 users  should choose Blue Wave/OS2 as their
  915.        mail reader.   This version is also NOT recommended for users who rely
  916.        on the  speech hardware/software interface in Blue Wave/DOS.  Although
  917.        this version  of the  mail reader does provide a speech-friendly video
  918.  
  919.                  --------------------------------------------------
  920.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 16
  921.  
  922.        mode, it  is extremely  slow.  This is due to the fact that writing to
  923.        the PC-BIOS requires a switch from protected mode to real mode.  Since
  924.        PC-BIOS compatible  video writes  can only  be done one character at a
  925.        time, this causes a severe performance penalty.
  926.  
  927.        Blue Wave/386 utilizes the DOS4GW protected mode runtime loader.  This
  928.        DOS extender may exhibit some incompatibilities on some hardware.  The
  929.        author has  one such  machine.   It is  highly  recommended  that  you
  930.        install and use this version before blindly purchasing a copy as there
  931.        is a  slight chance  that it  may not work for you.  Sorry, no refunds
  932.        can be given once you receive a registration number.
  933.  
  934.  
  935.        Section 4.2.3  Requirements for Blue Wave/OS2
  936.  
  937.        Blue Wave/OS2  has no  special hardware requirements, other than those
  938.        required to  run OS/2 itself.  If you are running OS/2 v2.0 or higher,
  939.        this mail reader will most likely work for you.
  940.  
  941.        Blue Wave/OS2  has all  of the  features and options available in Blue
  942.        Wave/DOS and  Blue Wave/386.   It  is a 32-bit text mode program which
  943.        can either  be run full-screen or on the OS/2 desktop.  (It is *not* a
  944.        Presentation Manager application.)
  945.  
  946.        As with  Blue Wave/386, Blue Wave/OS2 can handle any number of message
  947.        areas, any  number of  messages in an area, and messages of nearly any
  948.        length.   The only  limit is the amount of memory that OS/2 can supply
  949.        to the mail reader.  (The available memory is limited to the amount of
  950.        actual RAM  installed on  your computer,  plus the amount of free disk
  951.        space available  to the  OS/2 swap  file).   As  with  the  other  two
  952.        versions of  the mail reader, Blue Wave/OS2 is very efficient with its
  953.        memory usage.  Considering this fact, and assuming available swap file
  954.        space of  approximately 3  megabytes, there  is  nothing  this  reader
  955.        *won't* load!   An  average sized mail packet probably would cause the
  956.        mail reader to not use any more than 300K of system memory resources.
  957.  
  958.        Although Blue  Wave/DOS runs extremely well in an OS/2 DOS session, it
  959.        is recommended  that you  use the native OS/2 mail reader if possible.
  960.        There is  much less of a performance hit on other running applications
  961.        when using native OS/2 software.
  962.  
  963.  
  964.        Section 4.3  Locating Other Blue Wave Versions
  965.  
  966.        All Blue Wave Offline Mail Reader and Door versions are distributed as
  967.        ShareWare.   If you  would like  to try  a version of the mail door or
  968.        reader but  cannot find a copy locally, or you would like to make sure
  969.        you obtain  an unaltered  distribution file, here are some alternative
  970.        methods for getting an evaluation copy:
  971.  
  972.        *    The latest  versions of  our software  are always  available  for
  973.             first time  callers to  download through  our support  BBS.   Our
  974.             support BBS phone number is +1-810-743-8464.
  975.  
  976.  
  977.  
  978.                  --------------------------------------------------
  979.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 17
  980.  
  981.        *    You can  receive a  disk directly  from Cutting Edge Computing by
  982.             sending $5.00  (US Dollars)  to our  mailing address given on the
  983.             title page  of this  documentation.  Please specify 3.5" or 5.25"
  984.             disk size  and the  version(s) of the mail door and/or reader you
  985.             would like.   You can use the file REGISTER.BW, which should have
  986.             been included in the mail door distribution archive, to a request
  987.             a disk.
  988.  
  989.        *    If you have Internet access, the latest version of the mail doors
  990.             and mail  readers are always available through our World Wide Web
  991.             Site.  Simply point your web browser to:
  992.  
  993.                            http://www.cris.com/~bluewave.
  994.  
  995.  
  996.        *    We try  to keep the latest versions of the mail reader on America
  997.             Online.  Use the file finder to search for "Blue Wave".
  998.  
  999.  
  1000.        Section 4.4  Required External Programs
  1001.  
  1002.        When a  user downloads message packets from your BBS system, they will
  1003.        always be  compressed with  some type  of compression  program.    The
  1004.        program used  to compress  these mail  packets is  sometimes called an
  1005.        archiver, or  compression utility.   We  would be  willing to hazard a
  1006.        guess that  95% or  more of  the mail systems online today support the
  1007.        use of  a ZIP-format  compatible archiver.   It  is suggested that you
  1008.        obtain a  ZIP compression  and decompression  program.  Without these,
  1009.        your mail door probably will be unable to communicate with many of the
  1010.        mail readers available today.
  1011.  
  1012.        The most  popular ZIP compression and decompression programs come from
  1013.        the author  and creator of the ZIP archive format;  Phil Katz, founder
  1014.        of PKWARE,  Inc.   PKZIP and PKUNZIP are distributed in the same file,
  1015.        normally called  PKZ204G.EXE.   (At the  time this  documentation  was
  1016.        written, v2.04g  of PKZIP/PKUNZIP  was the  latest version available).
  1017.        PKZIP and  PKUNZIP are  ShareWare programs,  and are almost definitely
  1018.        available from the same source you received The Blue Wave Offline Mail
  1019.        Door.   Blue Wave  is  distributed  through  BBS  systems  and  online
  1020.        services in  the ZIP  compression format,  so it  is likely  that  you
  1021.        already have a copy.
  1022.  
  1023.        InfoZip is  another PKZIP  compatible archive  program.    InfoZip  is
  1024.        released with source code, and is available for download from many BBS
  1025.        systems.  These programs are usually named ZIP.EXE and UNZIP.EXE.  The
  1026.        InfoZip  utilities  are  available  for  several  different  operating
  1027.        systems including  DOS and OS/2.  (OS/2 users should get a copy of the
  1028.        OS/2 flavor of InfoZip for use with Blue Wave/OS2).
  1029.  
  1030.        If you  cannot find  a copy  locally, you  are welcome to download the
  1031.        above utilities  from the  Blue Wave  Support BBS  from the "Blue Wave
  1032.        Reader" file directory (Area #1).
  1033.  
  1034.  
  1035.        Section 4.5  MS-DOS CONFIG.SYS Settings
  1036.  
  1037.                  --------------------------------------------------
  1038.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 18
  1039.  
  1040.  
  1041.        If you  are using  the mail  door under  the  MS-DOS  (or  compatible)
  1042.        operating system  -- either  alone or  with Microsoft  Windows --  you
  1043.        should make  sure that  the following  items are  set properly in your
  1044.        CONFIG.SYS file.
  1045.  
  1046.        CONFIG.SYS is  a system  startup configuration  file  that  is  always
  1047.        located  in  the  root  directory  of  the  DOS  boot  drive  (usually
  1048.        C:\CONFIG.SYS).   If you  do not  have a  CONFIG.SYS file,  it will be
  1049.        necessary to create one.
  1050.  
  1051.        Load CONFIG.SYS  into a  text editor  and make  sure there  is a  line
  1052.        somewhere which reads:
  1053.  
  1054.             FILES=25
  1055.  
  1056.        This line  tells DOS  at boot time to allocate 25 file handles for use
  1057.        by programs  that you  will be running on your system.  If you already
  1058.        have a "FILES=" line in your CONFIG.SYS, and the number after it is 25
  1059.        or higher,  there will  be no  problems.   A value higher than 25 will
  1060.        work just  fine, but  a lower  value can  cause problems.  If the mail
  1061.        door attempts to open a file for reading or writing, and there are not
  1062.        enough DOS file handles available, the open will fail.
  1063.  
  1064.        The last  item to  check in  your CONFIG.SYS  file is  the  number  of
  1065.        buffers that  you  are  allowing  DOS  to  allocate  for  faster  disk
  1066.        accesses.   In your  CONFIG.SYS file,  you should  have  a  line  that
  1067.        contains the following:
  1068.  
  1069.             BUFFERS=30
  1070.  
  1071.        This tells  DOS to  allocate enough  system memory  to  hold  30  disk
  1072.        buffers.  This in turn allows DOS to perform disk intensive activities
  1073.        much more  quickly than  normal.   If the  number of  buffers in  your
  1074.        CONFIG.SYS file is already set higher than 30, that is perfectly fine.
  1075.        If you are running a disk caching program, you can ignore this advice,
  1076.        and follow  the instructions  that were given in the documentation for
  1077.        your disk  caching program.   Most disk caching programs will instruct
  1078.        you to use a very low value for the "BUFFERS=" statement in CONFIG.SYS
  1079.        because the  cache program can use the memory in a much more efficient
  1080.        manner than DOS does.
  1081.  
  1082.        If you  have made  changes to your CONFIG.SYS file, please remember to
  1083.        reboot your system so that the new settings will take effect.
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.                  --------------------------------------------------
  1097.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 19
  1098.  
  1099.  
  1100.  
  1101.                             -------------------------------------------------
  1102.                             Chapter 5:  INSTALLING THE MAIL DOOR INTO MAXIMUS
  1103.                             -------------------------------------------------
  1104.  
  1105.  
  1106.        Section 5.1  Mail Door Installation
  1107.  
  1108.        The mail  door is distributed in an archive called BWnnnMAX.ZIP, where
  1109.        'nnn' is  the version  number of  the mail  door.  In BWnnnMAX.ZIP you
  1110.        will find  this documentation file, any necessary conversion programs,
  1111.        and a  README.1ST file.    Please  --  always  be  sure  to  view  the
  1112.        README.1ST file before attempting to install the mail door.
  1113.  
  1114.        If you  are upgrading  from a previously-installed version of the mail
  1115.        door, installation/upgrade  instructions will  always be  found in the
  1116.        file README.1ST.  The installation instructions in this section of the
  1117.        documentation apply to new installations only.
  1118.  
  1119.        All of  the base  mail door  files (online  help  files,  introductory
  1120.        screens, BWSETUP.EXE,  BWMAIL.EXE, and  BWMAIL.OVR) are  contained  in
  1121.        another  archive   called  BWMAIL.ZIP.     Create   a  new   directory
  1122.        specifically for  the mail  door.  Making a seperate directory for the
  1123.        Blue Wave distribution files will make life easier in the long run.
  1124.  
  1125.        Here are step-by-step quick installation instructions:
  1126.  
  1127.        1)   Unpack BWMAIL.ZIP into your new mail door directory.
  1128.  
  1129.        2)   Change to  your new  mail door  directory  and  run  BWSETUP.EXE.
  1130.             (This file  should have  been unpacked  in step  number 1 above).
  1131.             This will  load the  door's installation  module  and  guide  you
  1132.             through the initial setup procedures.  You will first be prompted
  1133.             to enter  the path and file name of your Maximus-style .PRM file.
  1134.             This is  normally called MAX.PRM -- it is generated each time you
  1135.             run SILT.EXE.   If the installation module can open the .PRM file
  1136.             you specify,  it will  load as  much information as possible from
  1137.             your existing Maximus setup.
  1138.  
  1139.        3)   Each message  area that  you have defined in Maximus will be used
  1140.             by the  mail door  EXACTLY as  it is defined within the BBS.  The
  1141.             mail door  reads  all  message  area  definitions  directly  from
  1142.             Maximus's AREA.DAT  file.   This includes  security levels,  area
  1143.             locks, private/non-private status, etc.
  1144.  
  1145.        4)   After a few seconds, BWSETUP will show you a screen informing you
  1146.             that it  has gathered as much data as possible.  The installation
  1147.             program also  installed  several  sample  archiver  and  protocol
  1148.             configurations into  your setup.    At  this  time,  it  will  be
  1149.             necessary to  "walk" through *each* menu item of the installation
  1150.             and maintenance utility in order to enter information that cannot
  1151.             be found  through your  Maximus setup.   Each  menu item  in  the
  1152.             BWSETUP program  is described  in detail through online help.  If
  1153.             you need help at any time while using BWSETUP, please press <F1>.
  1154.  
  1155.                  --------------------------------------------------
  1156.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 20
  1157.  
  1158.             The help  system is context sensitive and provides links to other
  1159.             related help topics.
  1160.  
  1161.        5)   At this  point your  new mail  door has  been installed.  Now you
  1162.             need to  edit your  Maximus configuration  to include  a new menu
  1163.             item (or  items) for  your mail  door, and  some modifications to
  1164.             your message  area definitions  may be  necessary.   If  you  are
  1165.             running a  multi-node system,  other setup procedures may also be
  1166.             necessary.   Please read  this entire  chapter to  determine what
  1167.             changes to the default mail door configuration may be necessary.
  1168.  
  1169.  
  1170.        Section 5.2  Maximus Menu and Message Area Setup
  1171.  
  1172.        If you have installed other external programs into your Maximus setup,
  1173.        you should  have absolutely  no problem  installing The Blue Wave Mail
  1174.        Door.   If you  have never  installed external programs into your BBS,
  1175.        don't worry.  This section will guide you through the process and have
  1176.        you back up-and-running in no time at all.
  1177.  
  1178.        1)   When you  ran the  BWSETUP installation module, it created a file
  1179.             called  BWDOOR.BAT  (BWDOOR.CMD  if  you  are  running  the  OS/2
  1180.             version) in  your Blue Wave Mail Door directory.  This batch file
  1181.             was created  with the  paths  and  file  names  taken  from  your
  1182.             initialization parameters,  and should  be fully  functional with
  1183.             your system  -- as  long as  you have not changed anything around
  1184.             since you  executed the  installation module.    The  batch  file
  1185.             contains the following lines:
  1186.  
  1187.                  @ECHO OFF
  1188.                  C:
  1189.                  CD \MAX\BLUEWAVE
  1190.                  BWMAIL %1 %2 %3 %4 %5 %6 %7 %8 %9
  1191.  
  1192.        2)   To get  Maximus to supply the user with a menu item to access The
  1193.             Blue Wave  Mail Door,  you will  need to edit your MENUS.CTL file
  1194.             (in your  \MAX directory).   You  can place  the menu item on any
  1195.             system menu  you choose.   Suggested menus are the MAIN menu, the
  1196.             MESSAGE menu,  or you can create a new BLUEWAVE menu for the mail
  1197.             door.  Below is a menu entry that can be used for both single and
  1198.             multi-line systems.  THE ENTRIES IN MENUS.CTL ARE CASE-SENSITIVE.
  1199.             ENTER THE INFORMATION EXACTLY AS SHOWN!
  1200.  
  1201.        Maximus-OS/2
  1202.        ------------
  1203.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.CMD_/p%P_/t%k Twit "Blue Wave"
  1204.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.CMD_/p%P_/t%k_/d Twit "DL"
  1205.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.CMD_/p%P_/t%k_/u Twit "UL"
  1206.  
  1207.  
  1208.        Maximus-DOS
  1209.        -----------
  1210.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.BAT_/p%p_/t%k Twit "Blue Wave"
  1211.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.BAT_/p%p_/t%k_/d Twit "DL"
  1212.        ReRead Xtern_DOS C:\MAX\BLUEWAVE\BWDOOR.BAT_/p%p_/t%k_/u Twit "UL"
  1213.  
  1214.                  --------------------------------------------------
  1215.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 21
  1216.  
  1217.  
  1218.  
  1219.             The first menu command listed for both OS/2 and DOS will load the
  1220.             mail door  in "Interactive" mode.  The second menu command listed
  1221.             will load  the mail door in "Auto-Download" mode -- the mail door
  1222.             will immediately  begin a  mail scan  and download  for the user.
  1223.             The third  menu command  listed will load the mail door in "Auto-
  1224.             Upload" mode  -- the  mail door will immediately request the user
  1225.             to start the upload of a reply packet.  Please note that only the
  1226.             FIRST menu  command listed  above is required.  The Auto-Download
  1227.             and Auto-Upload menu commands are completely optional.
  1228.  
  1229.             The "ReRead"  keyword before  "Xtern_DOS" in  the  menu  commands
  1230.             above is  very important,  as it  tells  Maximus  to  reload  the
  1231.             information found  in the  LASTUSER.BBS file  after the  door has
  1232.             finished running.  The mail door updates important information in
  1233.             this file,  including  the  Download  Kbytes  (for  file  request
  1234.             sessions) and NetMail Credits and Debits information.
  1235.  
  1236.             Xtern_DOS tells  Maximus that when the user selects this item, it
  1237.             is going to shell to DOS or OS/2 and run the "BWDOOR" batch file.
  1238.  
  1239.             The path  shown in the example menu items is a sample, and should
  1240.             be changed  to reflect the actual drive, directory, and file name
  1241.             of the  batch file  that you  are going  to execute.   It is very
  1242.             important to  keep the  UNDERSCORE characters  in place.  Maximus
  1243.             will replace  the underscores  with spaces  before executing  the
  1244.             batch file.   The  "/t" and "/p" parameters will be passed to the
  1245.             batch file  telling the door the task number and port to use.  If
  1246.             you want or need further information on running external programs
  1247.             with Maximus, please see the Maximus documentation.
  1248.  
  1249.        3)   At this  time you  should  run  SILT(P).EXE  (supplied  with  the
  1250.             Maximus BBS system) to update the Maximus configuration.
  1251.  
  1252.        4)   You will  now need  to load  your MSGAREA.CTL file (the file that
  1253.             contains Maximus'  message area  information) into  your favorite
  1254.             text editor to verify that each message area that you want active
  1255.             in the door contains a "MsgName <AreTag>" token line.  Because of
  1256.             the way  that The  Blue Wave  Mail Door  tracks information about
  1257.             each user  and which message areas have been tagged for download,
  1258.             it is  absolutely necessary to perform this step.  (Don't worry -
  1259.             once you  do it, you'll never have to do it again!)  The "MsgName
  1260.             <AreaTag>" token  in MSGAREA.CTL is normally only used by Maximus
  1261.             for EchoMail  areas.  Because of this, you probably do not have a
  1262.             "MsgName <AreaTag>"  token defined  for any  of your  NetMail  or
  1263.             Local message areas.
  1264.  
  1265.             You can  select any  <AreaTag> you like for the Local and NetMail
  1266.             message areas.   "NETMAIL"  is a good tag to use for your NetMail
  1267.             area, and  something like  "USERCHAT", "CHATTER",  "COMMENTS", or
  1268.             "MAIN_AREA" are some ideas to use for your local areas.  The only
  1269.             requirement is  that you  do  not  duplicate  <AreaTags>  between
  1270.             message areas.
  1271.  
  1272.  
  1273.                  --------------------------------------------------
  1274.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 22
  1275.  
  1276.        5)   If it was necessary to edit your MSGAREA.CTL file in step number
  1277.             4, it will be necessary to SILT your Maximus control files once
  1278.             again.
  1279.  
  1280.        6)   If you followed these instructions exactly, the mail door should
  1281.             now be ready for use.  To test your setup, simply log into your
  1282.             BBS and select the new menu item you placed into the system.  If
  1283.             the mail door fails to execute properly, check the Maximus log
  1284.             file and the BW.LOG file for clues as to what went wrong.  You
  1285.             may want to carefully go over the installation instructions once
  1286.             again to make sure you didn't miss anything.
  1287.  
  1288.        7)   If you  are running  a Multi-Node Maximus system, please continue
  1289.             on   to    the   section    titled    "Multi-Node    Installation
  1290.             Considerations".
  1291.  
  1292.        8)   If you  are interested in using The Blue Wave Mail Door for local
  1293.             downloads and uploads, please see Chapter 7.
  1294.  
  1295.  
  1296.        Section 5.3  BWMAIL Command Line Parameters
  1297.  
  1298.        The Blue  Wave Mail  Door accepts  several command  line parameters in
  1299.        order for  you to  override certain  settins and  defaults within your
  1300.        BWMAIL.PRM  configuration   file.     Command  line   parameters  take
  1301.        precendence over  all settings,  including environment variables.  The
  1302.        following is a description of all available command line parameters.
  1303.  
  1304.        Although all  command line  parameters described here are shown with a
  1305.        dash preceeding the switch, a forward slash may also be used.
  1306.  
  1307.  
  1308.        BWMAIL.PRM Override (-c)
  1309.        ------------------------
  1310.             Multi-line users may wish to maintain separate Blue Wave PRM
  1311.             files, one  for each  node.   By default, the door will load
  1312.             BWMAIL.PRM.   If you  use the -c command line parameter, you
  1313.             can override this default.  The command line:
  1314.             BWMAIL -cLINE2.PRM
  1315.             would load  the door's parameter file called LINE2.PRM.  (If
  1316.             you wish  to maintain  separate PRM files between nodes, you
  1317.             can edit  others with  BWSETUP by specifying the name of the
  1318.             configuration file on the command line:  "BWSETUP LINE2.PRM"
  1319.             would allow you to edit the parameters in "LINE2.PRM".
  1320.  
  1321.             USAGE  :  BWMAIL -c<bwave.prm name>
  1322.             DEFAULT:  BWMAIL.PRM
  1323.  
  1324.  
  1325.        Maximus PRM File Override (-s)
  1326.        ------------------------------
  1327.             When the  door initializes,  the first file that it loads is
  1328.             BWMAIL.PRM, or  the file  that you  specified on the command
  1329.             line  with  the  -c  command  line  parameter.    BWMAIL.PRM
  1330.             contains the  path and  file name  of the Maximus-style .PRM
  1331.  
  1332.                  --------------------------------------------------
  1333.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 23
  1334.  
  1335.             file  that   will  be   loaded  when  that  particular  door
  1336.             configuration file  is used.   (See  also the section titled
  1337.             MULTI-LINE CONSIDERATIONS).
  1338.  
  1339.             If you  would like  to override the default contained within
  1340.             BWMAIL.PRM, use the command line:
  1341.             BWMAIL -sC:\Max\Node2.Prm
  1342.  
  1343.             USAGE  :  BWMAIL -s<Maximus .PRM name>
  1344.             DEFAULT:  .PRM name defined in the configuration file.
  1345.  
  1346.  
  1347.        Port Override (-p)
  1348.        ------------------
  1349.             By default,  The Blue Wave Mail Door uses the port contained
  1350.             within   the    MAX.PRM   file   that   is   loaded   during
  1351.             initialization.   If, for  some reason  such  as  multi-node
  1352.             operation, you  need to  OVERRIDE this parameter, use the -p
  1353.             command line.   (Port 0=COM1, Port 1=COM2, for Maximus-DOS).
  1354.             The door  will support  any port that you would like to use,
  1355.             as long as it can communicate with your FOSSIL driver.
  1356.  
  1357.             ** The OS/2 mail door *MUST* receive the communications port
  1358.             handle from Maximus.
  1359.  
  1360.             USAGE  : BWMAIL -p<0-based port number>
  1361.             DEFAULT: Found from the MAX.PRM file loaded by the door.
  1362.  
  1363.  
  1364.        Task/Node Override (-t)
  1365.        -----------------------
  1366.             The Blue  Wave Mail  Door uses  the task number contained in
  1367.             MAX.PRM by  default.   You can override the task number used
  1368.             by using  the "-t"  command line  parameter.   This will  be
  1369.             absolutely necessary  for multi-node systems!  The door uses
  1370.             this information  in the  translation of  the "%N"  and "%T"
  1371.             macros in  the Directories and File Paths editor of BWSETUP.
  1372.             The task  number *must* correspond to the user's task number
  1373.             within Maximus  or the door could load the wrong information
  1374.             about  the   current  user  or  cause  SHARE  violations  if
  1375.             task/node numbers shared between nodes.
  1376.  
  1377.             USAGE  : BWMAIL -t<task/node number>
  1378.             DEFAULT: Task number found in MAX.PRM.
  1379.  
  1380.  
  1381.        Local User Override (-k)
  1382.        ------------------------
  1383.             Normally, The Blue Wave Mail Door can detect when there is a
  1384.             local user  through the  LASTUSER.BBS file  that is  loaded.
  1385.             However, if  there is  some type  of problem with the door's
  1386.             auto-detection, and  you wish to run the door in local mode,
  1387.             you will need to specify the -k parameter.
  1388.  
  1389.  
  1390.  
  1391.                  --------------------------------------------------
  1392.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 24
  1393.  
  1394.             The -k  can also  be used  to automatically  load a selected
  1395.             user out  of Maximus' USER.BBS file and log them in locally.
  1396.             This method  allows the  use of the mail door without having
  1397.             to first  log into  the BBS.   The best use for this is when
  1398.             running the  door in local mode to bundle mail for the SysOp
  1399.             or other  users that  may want  to use The Blue Wave Offline
  1400.             Mail System.   The -k command line parameter is described in
  1401.             greater detail in Chapter 7 -- Local Mail Door Usage.
  1402.  
  1403.  
  1404.        Local Color (-MONO)
  1405.        -------------------
  1406.             The Blue  Wave Mail  Door will  always output  color to  the
  1407.             local screen,  even if  the remote  user  has  TTY  graphics
  1408.             enabled.  Sometimes this color is not desireable, especially
  1409.             on Monochrome systems.  Since the door contains so much BLUE
  1410.             most of the text appears underlined.
  1411.  
  1412.             To disable  color output to the local console, use the -mono
  1413.             command line  switch.   This switch  has no  effect  on  the
  1414.             remote user.
  1415.  
  1416.             USAGE  : BWMAIL -mono
  1417.             DEFAULT: Local color output.
  1418.  
  1419.  
  1420.        Carrier Detect Override (-NOCD)
  1421.        -------------------------------
  1422.             Normally, The  Blue Wave  Mail Door  requires that a carrier
  1423.             detect signal  be present in order for the door to send data
  1424.             through the  FOSSIL and  serial port.   This poses a problem
  1425.             when trying  to run  the door through a NULL Modem Cable, or
  1426.             something similar.
  1427.  
  1428.             If the command line switch -NOCD is added, no carrier detect
  1429.             function will  be activated,  and data  will be sent through
  1430.             the port specified with the -P<port> command line parameter.
  1431.  
  1432.             This switch  should NOT  be used  with a remote user online,
  1433.             since the  caller may  drop carrier  and tie  up your system
  1434.             until there is an input timeout (4 minutes).
  1435.  
  1436.             USAGE  : BWMAIL -NOCD
  1437.             DEFAULT: CD is ACTIVE unless LOCAL mode forced or detected.
  1438.  
  1439.  
  1440.        DESQview Detection Override (-NODV)
  1441.        -----------------------------------
  1442.             If the  door detects  that it is running under QuarterDeck's
  1443.             DESQview multi-tasker,  it will automatically write directly
  1444.             to DV's video buffer to eliminate screen write bleed-through
  1445.             and give  away time  slices to  other tasks when the door is
  1446.             idle.  To eliminate this behaviour, use the -NODV parameter.
  1447.  
  1448.  
  1449.  
  1450.                  --------------------------------------------------
  1451.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 25
  1452.  
  1453.             When DESQview support is enabled in the door, a line will be
  1454.             logged to your defined LOG file, informing you of this fact.
  1455.  
  1456.             USAGE  : BWMAIL -NODV
  1457.             DEFAULT: DESQview support used automatically if DV detected.
  1458.  
  1459.  
  1460.        Stamping Downloaded Messages as "Rec'd" (-NORECV)
  1461.        -------------------------------------------------
  1462.             When The Blue Wave Mail Door gathers messages for a user, it
  1463.             stamps all personal messages TO: that user as "Received", to
  1464.             give an  indication to  the sender that the message may have
  1465.             been read.   The  -NORECV command  line parameter causes the
  1466.             door to  skip the  process of  marking messages  as "Rec'd",
  1467.             leaving no  indication that  the message(s)  downloaded have
  1468.             been read.
  1469.  
  1470.             This parameter  probably should  not be  used for normal BBS
  1471.             usage.   The switch may come in handy, however, if the SysOp
  1472.             wishes  to   download  his/her   mail,  but  not  leave  any
  1473.             indication that  the message  had been read.  (The SysOp may
  1474.             not have  time to  reply to  the messages downloaded at that
  1475.             particular time).
  1476.  
  1477.             USAGE  : BWMAIL -NORECV
  1478.             DEFAULT: Marks personal messages as "Rec'd" when bundled.
  1479.  
  1480.  
  1481.        Work Directory Override (-WORK=)
  1482.        --------------------------------
  1483.             If you  would like  to override  the default  WORK directory
  1484.             defined within  BWMAIL.PRM,  use  the  -WORK=<path>  command
  1485.             line.
  1486.  
  1487.             USAGE  : BWMAIL -WORK=d:\path\to\workdir
  1488.             DEFAULT: Drive and path defined within BWMAIL.PRM
  1489.  
  1490.  
  1491.        Download Directory Override (-DOWN=)
  1492.        ------------------------------------
  1493.             To override  the door's  default DOWNLOAD  directory, simply
  1494.             specify the drive and path to use on the command line in the
  1495.             form -DOWN=<path>.
  1496.  
  1497.             USAGE  : BWMAIL -DOWN=d:\path\to\downdir
  1498.             DEFAULT: Directory defined within BWMAIL.PRM
  1499.  
  1500.  
  1501.        Upload Directory Override (-UPLOAD=)
  1502.        ------------------------------------
  1503.             To override  the door's  default UPLOAD  directory from  the
  1504.             command line, add the command line parameter -UPLOAD=<path>.
  1505.  
  1506.             USAGE  : BWMAIL -UPLOAD=d:\path\to\upld_dir
  1507.             DEFAULT: Drive and path defined within BWMAIL.PRM
  1508.  
  1509.                  --------------------------------------------------
  1510.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 26
  1511.  
  1512.  
  1513.  
  1514.        Log File Override (-LOG=)
  1515.        -------------------------
  1516.             Each copy  of The  Blue  Wave  Mail  Door  that  is  running
  1517.             requires a  separate log  file.   Log files cannot be shared
  1518.             between two  or more  different tasks.  This command line is
  1519.             used to  override the  log file  name that is defined within
  1520.             BWMAIL.PRM.   In most  cases, it would be more convenient to
  1521.             use the '%T' or '%N' replacement macro in declaring the name
  1522.             of the log file within the BWSETUP Directories and File Name
  1523.             Editor.   However, this  alternate way of overriding the log
  1524.             file name  is provided  for special situations.  To override
  1525.             the log  file name  from the  door's command line, use the -
  1526.             LOG=<file> parameter.
  1527.  
  1528.             This parameter  can also  be convenient when you do not want
  1529.             to keep  a log  file for  a certain  task (usually  a  local
  1530.             node).   If the  door receives  the command  line  parameter
  1531.             "BWMAIL -LOG=",  no log  file will  be  generated  for  that
  1532.             session.
  1533.  
  1534.             USAGE  : BWMAIL -LOG=d:\name\of\logfile.ext
  1535.             DEFAULT: Filename defined within BWMAIL.PRM.
  1536.  
  1537.  
  1538.        Auto-Download Mode (-d)
  1539.        -----------------------
  1540.             The Blue Wave Mail Door has a special command line parameter
  1541.             to force  the door  into download mode, then exit.  When the
  1542.             door is  executed with  the  -d  parameter,  it  immediately
  1543.             begins scanning the message areas and bundles a mail packet.
  1544.             If there is a remote user, the door will immediately fire up
  1545.             the appropriate download protocol, and then exit back to the
  1546.             BBS.   If there  is no remote user, the door skips executing
  1547.             the protocol,  and drops  back to  the calling  batch  file.
  1548.             This is  extremely handy  for local  use in  batch files  to
  1549.             possibly build  a mail  bundle during a maintenance "event".
  1550.             The door  will NOT  prompt for  user input during the entire
  1551.             session.
  1552.  
  1553.             USAGE  : BWMAIL -D
  1554.             DEFAULT: The door defaults to "Interactive Menu" mode.
  1555.  
  1556.  
  1557.        Auto-Upload Mode (-u)
  1558.        ---------------------
  1559.             Specifying -U  on the  command line  will cause  the door to
  1560.             immediately go  into upload  mode.  This parameter works the
  1561.             same as the Auto-Download Parameter;  the user will never be
  1562.             prompted for input during the mail session.
  1563.  
  1564.             USAGE  : BWMAIL -U
  1565.             DEFAULT: The door defaults to "Interactive Menu" mode.
  1566.  
  1567.  
  1568.                  --------------------------------------------------
  1569.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 27
  1570.  
  1571.  
  1572.        Auto Logoff Mode - INSTANT or COUNTDOWN
  1573.        ---------------------------------------
  1574.             These command  line switches  only have  an  effect  on  the
  1575.             operation of  the door  when the  following 2 conditions are
  1576.             met:
  1577.  
  1578.             1)  The door must be in Auto-Upload or Auto-Download mode.
  1579.             2)  There must be a remote user online.
  1580.  
  1581.             Adding the  -INSTANT command  line parameter  will cause the
  1582.             door to  perform an  IMMEDIATE  LOGOFF  of  the  user  (drop
  1583.             carrier) after  a successful  Auto-Upload  or  Auto-Download
  1584.             session.
  1585.  
  1586.             Adding the -COUNT command line parameter will cause the door
  1587.             to perform  a COUNTDOWN  LOGOFF of  the user  (drop  carrier
  1588.             after a  10 second countdown) after a successful Auto-Upload
  1589.             or Auto-Download session.
  1590.  
  1591.             USAGE  : BWMAIL <-D or -U> -INSTANT
  1592.             USAGE  : BWMAIL <-D or -U> -COUNT
  1593.             DEFAULT: The door defaults to returning back to the BBS with
  1594.                      the remote user still online.
  1595.  
  1596.  
  1597.        Section 5.4  Multi-Node Installation Considerations
  1598.  
  1599.        The Blue  Wave Mail Door is fully capable of multi-node operation, and
  1600.        provides facilities  for ease of operation and configuration on multi-
  1601.        node systems.  There are a few points that you need to be aware of.
  1602.  
  1603.        All nodes  on your  system can  use the same \BLUEWAVE base directory.
  1604.        Full file sharing and file locking is supported.  You can use the same
  1605.        door configuration  file (BWMAIL.PRM)  on all  nodes on your system if
  1606.        you like.   It  is also possible to use DIFFERENT BWMAIL.PRM files for
  1607.        each node  on your  system by using the -C<door prm name> command line
  1608.        parameter to  BWMAIL.EXE.   Many (if  not all)  of the  necessary door
  1609.        parameters that  can vary  between nodes  can be  passed on the door's
  1610.        command  line,  thereby  overriding  any  information  in  the  door's
  1611.        configuration file.   It is highly suggested that you read the "BWMAIL
  1612.        Command  Line  Parameters"  section  of  the  documentation  for  full
  1613.        information on these command line overrides.
  1614.  
  1615.        It is  also important to note that all nodes must have their own WORK,
  1616.        DOWNLOAD, and  UPLOAD directories.   Failure  to do  so will result in
  1617.        file name clashes between nodes if two users are using the door at the
  1618.        same time.  The solution for this problem is to either use the /DOWN=,
  1619.        /UPLOAD=, and  /WORK= command line parameters, or the "%T" and/or "%N"
  1620.        replacement macros  in the  BWSETUP Directories and File Paths editor.
  1621.        When the  door begins  execution, it  will replace  all occurrences of
  1622.        "%T" and  "%N" with  the task  number passed  to the  door through the
  1623.        /t<task#> command  line parameter.   (Press  <F1> while in the BWSETUP
  1624.        Directories and  File Paths  editor for more information on these task
  1625.        number replacement macros).
  1626.  
  1627.                  --------------------------------------------------
  1628.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 28
  1629.  
  1630.  
  1631.        To recap, the following problems must be avoided when running The Blue
  1632.        Wave Mail Door on a multi-node system:
  1633.  
  1634.        1)   Each task must have its own WORK directory.
  1635.        2)   Each task must have its own DOWNLOAD directory.
  1636.        3)   Each task must have its own UPLOAD directory.
  1637.        4)   Each task must have its own LOG file name.
  1638.  
  1639.        If the  above four  conditions are not met, your door will not perform
  1640.        as expected,  and you  may receive  SHARE violations  when two or more
  1641.        users are in the mail door at the same time.
  1642.  
  1643.  
  1644.        Section 5.5  Supported Maximus Features
  1645.  
  1646.        The Blue  Wave Mail  Door makes  every attempt  to be  compatible with
  1647.        Maximus 2.0x  with all Maximus message area configuration and security
  1648.        settings.   Below are  important items  to consider  when  determining
  1649.        whether not a particular Maximus feature is also supported in The Blue
  1650.        Wave Mail  Door.   If reference  to a particular feature of Maximus is
  1651.        unfamiliar  to   you,  please   see  the   Maximus  documentation  for
  1652.        implementation details.
  1653.  
  1654.             *    The Blue  Wave Mail  Door will honor all Extended Barricades
  1655.                  in both  message and  file areas.   This  includes new files
  1656.                  scanning, file requesting, and message area access.
  1657.  
  1658.             *    The Blue  Wave Mail Door *cannot* honor menu item overrides,
  1659.                  such as  E)nter Message on the MESSAGE menu.  Because of the
  1660.                  way menu  item overrides  are stored  in  the  Maximus  data
  1661.                  files, implementing this security override feature is nearly
  1662.                  impossible without "being" Maximus.
  1663.  
  1664.             *    The Blue  Wave Mail  Door will  cause  Maximus  to  use  the
  1665.                  ErrorLevel Exits  after mail  has been  uploaded *only* when
  1666.                  you use  the Xtern_ErLvl  menu option to load the mail door.
  1667.                  (ErrorLevel Exits,  as used  here, refer to the 'After Local
  1668.                  Exit nn', 'After Edit Exit nn', and 'After EchoMail Exit nn'
  1669.                  options in  MAX.CTL.)   Maximus provides no way of forcing a
  1670.                  specific errorlevel  exit when any other shell type is used.
  1671.                  If you  need to  do mail  processing after  a user logs off,
  1672.                  please see the BWSETUP Directories and File Paths Editor for
  1673.                  the use  of the  Mail Upload Semaphore files.  The mail door
  1674.                  will create  these 0-byte  files after certain types of mail
  1675.                  have been  uploaded.   You will  then need to use the DOS or
  1676.                  OS/2 "if  exist <filename>"  batch file construction to test
  1677.                  for the  existance of  these files  and do  your  processing
  1678.                  accordingly.
  1679.  
  1680.             *    Full cost  accounting and cost checking is performed through
  1681.                  a Version  6 or  Version 7 nodelist when NetMail is uploaded
  1682.                  to the mail door.
  1683.  
  1684.  
  1685.  
  1686.                  --------------------------------------------------
  1687.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 29
  1688.  
  1689.             *    When a  user uploads  FidoNet NetMail  messages through  the
  1690.                  mail door, Blue Wave will use the nodelist path and nodelist
  1691.                  type defined in Maximus.  The mail door supports the Version
  1692.                  6 nodelist  and the  Version  7  nodelist.    The  FrontDoor
  1693.                  nodelist is *not* supported.  If you have configured Maximus
  1694.                  to use  a FrontDoor  nodelist, all  NetMail uploaded through
  1695.                  the mail  door will be treated as if it were to an "Unlisted
  1696.                  Node".   The cost  accounting will  be done according to the
  1697.                  Unlisted   security   and   cost   settings   in   BWSETUP's
  1698.                  Netmail/Security Manager.
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.                  --------------------------------------------------
  1746.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 30
  1747.  
  1748.  
  1749.  
  1750.                                      ----------------------------------------
  1751.                                      Chapter 6:  INSTALLING EXTERNAL PROGRAMS
  1752.                                      ----------------------------------------
  1753.  
  1754.  
  1755.        Section 6.1  Installing External Support Programs
  1756.  
  1757.        Configuring external  programs for use with The Blue Wave Offline Mail
  1758.        Door is  perhaps the  single most important aspect of getting the mail
  1759.        system to  work properly.   Close to 100% of the problems that you may
  1760.        encounter while  using the mail door are due to incorrectly configured
  1761.        or missing program command lines.  This section of the documentation -
  1762.        - along  with the  following sub-sections  -- attempt  to explain,  in
  1763.        great detail,  the proper  way to  configure external programs for use
  1764.        with the mail system.
  1765.  
  1766.        It  is  important  to  remember  that  you  must  have  at  least  one
  1767.        compression  program   and  the  corresponding  decompression  program
  1768.        command line  defined in  order to operate the mail door successfully.
  1769.        ZIP-formatted mail  packets are so common that it is almost imperative
  1770.        that you  have a  ZIP compression  and ZIP decompression program. Most
  1771.        users will have some type of ZIP compression program already installed
  1772.        on their  system. (Please see Chapter 4 for more information regarding
  1773.        required external  programs).   For this  reason, you should read this
  1774.        chapter very carefully if you are having trouble getting the mail door
  1775.        to create a mail packet for download.
  1776.  
  1777.  
  1778.        Section 6.2  The PATH Environment Variable
  1779.  
  1780.        Throughout this  documentation, and  in many other program manuals you
  1781.        may read, you will see references to what is called "the system PATH",
  1782.        "the PATH environment variable", and "DOS (or OS/2) PATH".
  1783.  
  1784.        In order  to understand the configuration of external programs in this
  1785.        or any  other program,  it is  essential that you understand what this
  1786.        terminology is referring to.
  1787.  
  1788.        Each time you boot your computer, MS-DOS reads two configuration files
  1789.        from the  root directory  of your boot drive (usually C:\).  These two
  1790.        files are  called CONFIG.SYS  and AUTOEXEC.BAT.   The PATH environment
  1791.        variable is  configured in  the file AUTOEXEC.BAT under MS-DOS.  (Note
  1792.        that OS/2 uses the CONFIG.SYS file for setting the system PATH.)
  1793.  
  1794.        If you  load the  file AUTOEXEC.BAT  into a text file editor, you will
  1795.        probably see a line that reads:
  1796.  
  1797.             PATH c:\;c:\dos;c:\windows
  1798.  
  1799.        The names of the directories listed in this line may be different from
  1800.        above.   Each directory  name is  separated by a semi-colon (;).  If a
  1801.        program is  "located on  the system  PATH", it  simply means  that the
  1802.        file(s) needed  to run  this program  are in  one of  the  directories
  1803.  
  1804.                  --------------------------------------------------
  1805.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 31
  1806.  
  1807.        listed on  this line.   You  can add  new  directories  to  your  PATH
  1808.        statement by  simply editing  this line  to include  the new directory
  1809.        (make sure  that if  there are  any directories listed before or after
  1810.        the new  directory entry,  that you separate them with a semi-colon!).
  1811.        Under DOS,  the maximum  length of  this line  is 127  characters, and
  1812.        under OS/2 the maximum length of this line is 1024 characters.
  1813.  
  1814.        Please note that any changes you make to your CONFIG.SYS file and your
  1815.        AUTOEXEC.BAT file  will not  become effective  until you  REBOOT  your
  1816.        system.  They are only read by DOS and OS/2 once;  at system startup.
  1817.  
  1818.        When DOS,  OS/2, or  any program  running under  these  two  operating
  1819.        systems tries  to  run  a  program,  it  first  searches  the  current
  1820.        directory to see if the program is there.  If it is there, the program
  1821.        is run  from the  current directory.  If it is NOT there, DOS and OS/2
  1822.        begin searching  the directories listed in this line.  The directories
  1823.        are searched in the order they appear.  If, after searching the entire
  1824.        list of  directories contained  in this  line, the  program cannot  be
  1825.        found, DOS will issue this error message:
  1826.  
  1827.             Bad command or file name.
  1828.  
  1829.        The behavior  and use  of the  PATH environment  variable is described
  1830.        here because  DOS and  OS/2 will behave in the same manner as the mail
  1831.        door when it cannot find a program you have told it to run -- although
  1832.        the mail  door's error  messages are a bit more friendly.  Any program
  1833.        that you  try to  run through  the mail  door must  be located  on the
  1834.        system PATH.
  1835.  
  1836.        The purpose  of  the  system  PATH  environment  variable  is  one  of
  1837.        convenience.   If a  program is  located in a directory located on the
  1838.        system path,  that program can be run from ANY directory you happen to
  1839.        be in.   For  example, when  you  install  Windows,  it  installs  the
  1840.        C:\WINDOWS directory  on the  system path.  No matter where you are on
  1841.        your computer,  typing "WIN"  will start  the Windows Program Manager.
  1842.        If you  were to  remove "C:\WINDOWS"  from the  system path and reboot
  1843.        your  machine,   you  would  be  required  to  be  in  the  C:\WINDOWS
  1844.        subdirectory before Windows could load.
  1845.  
  1846.        While the  mail door  is running,  it changes  directories at  several
  1847.        different points  in time.   It is therefore not possible to place the
  1848.        external programs  in the door's base directory and expect them to run
  1849.        properly (unless  the mail  door directory  is in  your system  PATH).
  1850.        Most people  find it  convenient to  have one  or two directories that
  1851.        hold important system utility files (such as PKZIP and PKUNZIP).
  1852.  
  1853.  
  1854.        Section 6.3  Configuring External Archiver Programs
  1855.  
  1856.        In order  to pack and unpack messages that are downloaded and uploaded
  1857.        from your  system, it  is necessary  for the mail door to spawn (call,
  1858.        execute, run) external compression and decompression utilities.
  1859.  
  1860.        Configuring an  archiver  with  BWSETUP  is  fairly  straight-forward.
  1861.        Simply load  BWSETUP, highlight  the "Archiver Definitions" menu item,
  1862.  
  1863.                  --------------------------------------------------
  1864.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 32
  1865.  
  1866.        and press  [Enter].   You will  be presented  a list  of up  to  eight
  1867.        archivers --  highlight the  archiver you  would like to work with and
  1868.        press [Enter] again.
  1869.  
  1870.        To add  a new archiver definition, highlight one of the lines that are
  1871.        filled with  dots and  press [Enter].   You  will be  presented with a
  1872.        'blank' entry  screen in  which to define your archiver.  If you would
  1873.        like to  remove an  archiver from  the list, highlight the archiver to
  1874.        work with  in the selection list, press [Enter], then set the archiver
  1875.        hotkey to a [Space] character.
  1876.  
  1877.        Once you  have begun  editing an  archiver definition,  you will  find
  1878.        several fields  available to  you.   For questions  about any  of  the
  1879.        fields, press  <F1> while  that field  is highlighted.  The two fields
  1880.        that  deserve   deeper  explanation   here  are  the  Compression  and
  1881.        Decompression command lines.
  1882.  
  1883.        The compression  command line  is used  when the mail door is ready to
  1884.        send a mail packet to the user.  Several files are created in the mail
  1885.        door's temporary  working directory  that need to be compressed into a
  1886.        single file  for transmission to the user.  Here you need to enter the
  1887.        command line that should be executed in order to accomplish this task.
  1888.        Two macros  should be  used when defining archiver compression command
  1889.        lines.  Please see Sections 6.3.1 and 6.3.2 for more information.
  1890.  
  1891.        The decompression  command line  is used when the mail door receives a
  1892.        reply packet from the user (the user has uploaded messages to the mail
  1893.        door).   The mail  door calls the decompression command line to unpack
  1894.        the reply  messages to its temporary working directory for processing.
  1895.        Here you  need to  enter the  command line  that should be executed in
  1896.        order to  accomplish this  task.   Two  macros  should  be  used  when
  1897.        defining archiver  decompression command  lines.   Please see Sections
  1898.        6.3.1 and 6.3.2 for more information.
  1899.  
  1900.  
  1901.        Section 6.3.1  Macros Used for Archiver Definitions
  1902.  
  1903.  
  1904.        Two macros  should be used when defining your archiver compression and
  1905.        decompression command  lines in  order to  work properly with the mail
  1906.        door configuration  (especially with  multi-node  systems).    In  the
  1907.        descriptions below,  we will  assume  that  your  mail  door  Download
  1908.        Directory is  configured as  "C:\BBS\DOWN", that your mail door Upload
  1909.        Directory is  configured as  "C:\BBS\UP", that  your  mail  door  Work
  1910.        Directory is  configured as  "C:\BBS\WORK", and that your mail door is
  1911.        configured to use a Mail Packet ID of "MYBBS".
  1912.  
  1913.        @F   Use the  @F macro  in a compression command line to represent the
  1914.             name of the file that will be created by the compression program.
  1915.             For example,  to create  a .ZIP  file with  PKZIP, PKZIP needs to
  1916.             know the  name of the .ZIP file to create.  If your mail door was
  1917.             configured as described above, "PKZIP @F" would expand to:
  1918.  
  1919.                  PKZIP C:\BBS\DOWN\MYBBS.SU1
  1920.  
  1921.  
  1922.                  --------------------------------------------------
  1923.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 33
  1924.  
  1925.             Use the @F macro in a decompression command line to represent the
  1926.             name of the file that needs to be decompressed by the archiver.
  1927.             For example, to unpack a file with PKUNZIP, PKUNZIP needs to know
  1928.             the name of the file to decompress.  If your mail door was
  1929.             configured as described above, "PKUNZIP @F" would expand to:
  1930.  
  1931.                  PKUNZIP C:\BBS\UP\MYBBS.NEW
  1932.  
  1933.        @I   Use the  @I macro  in a compression command line to represent the
  1934.             path and  file name(s)  that will  be packed into the destination
  1935.             archive.     For   example,   to   create   an   archive   called
  1936.             C:\BBS\DOWN\MYBBS.SU1  with   all  of  the  files  found  in  the
  1937.             C:\BBS\WORK directory, you would issue the following command line
  1938.             for PKZIP:
  1939.  
  1940.                  PKZIP C:\BBS\DOWN\MYBBS.SU1 C:\BBS\WORK\*.*
  1941.  
  1942.             This same command line would be represented in the door as "PKZIP
  1943.             @F @I".
  1944.  
  1945.             Use the @I macro in a decompression command line to represent the
  1946.             destination path  of the  files that  will be  unpacked from  the
  1947.             archive.   For example,  to unpack  MYBBS.NEW to  the door's Work
  1948.             Directory (C:\BBS\WORK), you would issue the following command to
  1949.             PKUNZIP:
  1950.  
  1951.                  PKUNZIP MYBBS.NEW C:\BBS\WORK\
  1952.  
  1953.             This same  command line  would be  represented  in  the  door  as
  1954.             "PKUNZIP @F @I".
  1955.  
  1956.  
  1957.        Section 6.3.2  Sample Archiver Command Lines
  1958.  
  1959.        Sample archiver  commands are listed below which illustrate the use of
  1960.        the @F  and @I archiver macros.  All of these examples assume that the
  1961.        executable file  for the  archiver is located somewhere on your system
  1962.        PATH (see  Section 6.2).   All of these command lines have been tested
  1963.        with the mail door and have proven themselves to work.
  1964.  
  1965.        Sample DOS Archiver Command Lines
  1966.        ---------------------------------
  1967.  
  1968.        ZIP Compression  :  PKZIP -ex @F @I
  1969.        ZIP Decompression:  PKUNZIP -o @F @I
  1970.  
  1971.        ARJ Compression  :  ARJ a -e @F @I
  1972.        ARJ Decompression:  ARJ e -y @F @I
  1973.  
  1974.        LZH Compression  :  LHA a /m @F @I
  1975.        LZH Decompression:  LHA e /m @F @I
  1976.  
  1977.  
  1978.        Sample OS/2 Archiver Command Lines
  1979.        ----------------------------------
  1980.  
  1981.                  --------------------------------------------------
  1982.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 34
  1983.  
  1984.  
  1985.        ZIP Compression  :  ZIP -jk9 @F @I
  1986.        ZIP Decompression:  UNZIP -oj @F -d @I
  1987.  
  1988.        ARJ Compression  :  <no ARJ was available for OS/2>
  1989.        ARJ Decompression:  <you need ARJ compress to use ARJ decompress!>
  1990.  
  1991.        LZH Compression  :  LH a /o @F @I
  1992.        LZH Decompression:  LH e /o @F @I
  1993.  
  1994.  
  1995.        Section 6.3.3  Notes About Archiver Command Lines
  1996.  
  1997.        Please  note   that  you  must  have  at  least  one  compression  and
  1998.        decompression program  configured in  the mail door.  Some SysOps will
  1999.        find that  they never  have to install anything but ZIP.  However, the
  2000.        mail door  gives you  the ability  to define  up to  eight  individual
  2001.        compression types for users to choose from.
  2002.  
  2003.        PKZIP and  its companion program PKUNZIP are, by far, the most popular
  2004.        ZIP compression  and decompression utilities available for MS-DOS.  If
  2005.        you are  installing a  DOS version  of Blue  Wave, you  should install
  2006.        PKZIP.EXE and PKUNZIP.EXE in a directory on your system which contains
  2007.        other important  system utilities.  At the time this documentation was
  2008.        written, version  2.04g  was  the  latest  available  version  of  the
  2009.        PKZIP/PKUNZIP utilities.
  2010.  
  2011.        If you are using an OS/2 version of the mail door, you should find and
  2012.        obtain a copy of the InfoZip Project's ZIP.EXE and UNZIP.EXE for OS/2.
  2013.        It is  recommended that you use ZIP v2.01 or later, and UNZIP v5.12 or
  2014.        later, due  to bugs  and compatibility problems with earlier versions.
  2015.        These version  numbers of  ZIP/UNZIP are  known to work properly under
  2016.        OS/2 with  the Blue Wave Mail Door.  If you cannot find these programs
  2017.        locally, you are welcome to download them from our Support BBS.
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.                  --------------------------------------------------
  2041.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 35
  2042.  
  2043.  
  2044.  
  2045.                                           -----------------------------------
  2046.                                           Chapter 7:  OPERATING THE MAIL DOOR
  2047.                                           -----------------------------------
  2048.  
  2049.  
  2050.        Section 7.1  General Mail Door Operation
  2051.  
  2052.        Now that  we have  examined the operation of BWSETUP in detail and you
  2053.        have  gone   through  the   initial  installation  process,  it  seems
  2054.        appropriate to discuss the operation of the mail mail door itself.
  2055.  
  2056.        The main  bridge between your BBS software and The Blue Wave Mail Door
  2057.        is called  the "door  drop file."   This  file is  created by  all BBS
  2058.        software, but  the format and the name of the file varies depending on
  2059.        the software  you are  using.   QuickBBS, RemoteAccess,  SuperBBS, and
  2060.        ProBoard all  use a  file called EXITINFO.BBS.  Maximus and Opus use a
  2061.        file called  LASTUSxx.BBS or  LASTUSxx.DAT, where  'xx'  is  the  node
  2062.        number the  user is  currently using.   T.A.G. and Telegard use a file
  2063.        called DOOR.SYS.
  2064.  
  2065.        Each time  the mail door is loaded, information about the current user
  2066.        is loaded  from this door drop file.  This includes the user name, the
  2067.        speed at  which they  are logged  on, and other vital information.  In
  2068.        fact, if the mail door cannot load this file during initialization, it
  2069.        will refuse  to run.  (The exception to this is when the /K<user_name>
  2070.        command line parameter is used.  Please see the Sections titled "Using
  2071.        the Mail  Door in  Local Mode"  and "Command Line Parameters" for more
  2072.        information.)
  2073.  
  2074.        If all  of the  mail door's  initialization files could be loaded, all
  2075.        three of  the door's  private working  directories are  purged of  any
  2076.        files they  might be  holding.   These three directories, the Download
  2077.        Directory, Upload  Directory, and Work Directory, should never contain
  2078.        files that  you plan  on keeping.   These  are intended solely for the
  2079.        mail door's use, and the mail door expects them to be 'clean' in order
  2080.        to operate properly.
  2081.  
  2082.        After the  door has initialized itself and prepared for operation, the
  2083.        user will  be shown  either the  file BWINTRO.TXT  (if they  have ANSI
  2084.        graphics turned  off) or  BWINTRO.ANS.  If the user has never used the
  2085.        mail door  before, or if their mail door user record has been deleted,
  2086.        they will  be shown  the text in the file NEWUSER.HLP, followed by the
  2087.        default mail door configuration settings.
  2088.  
  2089.  
  2090.        Section 7.2  Functions Available While a User is Online
  2091.  
  2092.        The mail  door contains  several functions that the SysOp can activate
  2093.        while a  user is  online.   The mail  door is  always in "simultaneous
  2094.        keyboard mode",  meaning that  whatever you type on the local keyboard
  2095.        will also  be echoed  to the  remote user and processed just as if the
  2096.        key had  come from  the remote  user.   However, there are special key
  2097.        combinations that  do not  echo to the remote user, and that cannot be
  2098.  
  2099.                  --------------------------------------------------
  2100.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 36
  2101.  
  2102.        activated by  the remote  user.   In order  to perform  any  of  these
  2103.        functions, they *must* be activated from the SysOp's console.
  2104.  
  2105.        Before we  discuss the  "SysOp Keys",  let's explain some things about
  2106.        the status  bar on  the bottom  row of your screen.  The status bar is
  2107.        not visible to your remote users, of course.  During normal operation,
  2108.        you will  only see  one visible  line, however  there are actually two
  2109.        lines that  make up the status bar display.  When you press your SysOp
  2110.        keys, additional  information will  fill the second status line.  This
  2111.        additional information  will be  cleared, and  the status bar updated,
  2112.        every 15 seconds.
  2113.  
  2114.        Here are the keys available while a user is online:
  2115.  
  2116.             The <Home> Key
  2117.             --------------
  2118.             Pressing the  <Home> key  while a user is online will display all
  2119.             of the  function keys  available to you.  Think of the <Home> key
  2120.             as a mini online help guide.
  2121.  
  2122.             The <Alt-C> Key
  2123.             ---------------
  2124.             While a  user is  online, you can press the <Alt-C> key to "chat"
  2125.             with the  user.   Entering  chat  mode  allows  you  to  interact
  2126.             directly with the user at the remote end.  Each key that you type
  2127.             will be  echoed to  the remote user, and each key the remote user
  2128.             types will be sent to your screen.
  2129.  
  2130.             To exit chat mode at any time, simply press the <Esc> key.  After
  2131.             you exit  chat mode  with a  user, both the remote user's display
  2132.             and the local display will be repainted with the information that
  2133.             was on the screen at the time chat mode was entered.
  2134.  
  2135.             The <Alt-D> Key
  2136.             ---------------
  2137.             Pressing <Alt-D> while a user is online will perform an immediate
  2138.             shell to  the operating  system (DOS  or OS/2, depending on which
  2139.             mail door  type you  are running).   Don't worry, the remote user
  2140.             will not be able to see what you are doing!  A message is sent to
  2141.             the user  before the  shell is performed, and once again when you
  2142.             return from the shell.  Please remember that you must type "EXIT"
  2143.             at the DOS or OS/2 command line prompt in order to return control
  2144.             to the mail door.
  2145.  
  2146.             The <Alt-H> Key
  2147.             ---------------
  2148.             Made for  those users  who are just plain annoying or are abusing
  2149.             your system, the <Alt-H> keypress will perform a disconnect (drop
  2150.             carrier) and then exit the mail door.  Control is returned to the
  2151.             BBS system.   The BBS software should see that there is no longer
  2152.             a user online and should recycle the BBS system.
  2153.  
  2154.             The <Alt-N> Key
  2155.             ---------------
  2156.  
  2157.  
  2158.                  --------------------------------------------------
  2159.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 37
  2160.  
  2161.             The <Alt-N> keypress will cause the mail door to display extended
  2162.             information about  the current  user, including  their alias name
  2163.             and/or their  "real" name.   This information, as with all of the
  2164.             special function  key information,  will be  cleared in  about 15
  2165.             seconds for a more "tidy" appearance.
  2166.  
  2167.             The <PgDn> and <DownArrow> Keys
  2168.             -------------------------------
  2169.             Pressing <PgDn> while a user is online will decrease the time the
  2170.             user has  remaining in  the mail  door by ten minutes.  To reduce
  2171.             the time remaining by thirty minutes, simply press the <PgDn> key
  2172.             three times.  Pressing the <DownArrow> cursor key also lowers the
  2173.             current  user's  time  remaining,  but  does  so  in  one  minute
  2174.             increments.
  2175.  
  2176.             The <PgUp> and <UpArrow> Keys
  2177.             -----------------------------
  2178.             Pressing <PgUp> while a user is online will increase the time the
  2179.             user has  remaining in the mail door by ten minutes.  To increase
  2180.             the time remaining by thirty minutes, simply press the <PgUp> key
  2181.             three times.   Pressing  the <UpArrow>  cursor key also increases
  2182.             the current  user's time  remaining, but  does so  in one  minute
  2183.             increments.
  2184.  
  2185.  
  2186.        Section 7.3  Maintaining The Blue Wave Mail Door
  2187.  
  2188.        One of  the most  popular features  of The  Blue Wave Mail Door is the
  2189.        small amount  of maintenance  that is required.  Because the mail door
  2190.        operates directly  with your BBS software, no message area maintenance
  2191.        is required.  Each time the mail door loads, it reads all message area
  2192.        definitions   and   security   settings   directly   from   your   BBS
  2193.        configuration.  This means that once you have configured a new message
  2194.        area in  your BBS  configuration utility,  you do not have to add that
  2195.        same message area to the mail door configuration!
  2196.  
  2197.        The same  holds true  for removing  message area  definitions.  If you
  2198.        decide to  remove a message area from your BBS configuration, the mail
  2199.        door will  recognize that  the area  is no  longer available  and will
  2200.        automatically disable it from a user's mail scan.
  2201.  
  2202.        Section 7.3.1  Message Area Overrides
  2203.  
  2204.        The BWSETUP  program allows  you to  define "Message  Area Overrides".
  2205.        Message area  overrides allow  you to  override any  settings for  any
  2206.        message area  available on  your BBS.   Since  the mail door reads all
  2207.        information directly from your BBS system's configuration each time it
  2208.        loads, any  changes made  to the message area configuration in the BBS
  2209.        automatically get carried over to the mail door.
  2210.  
  2211.        It may  be desireable,  at times,  to override  the BBS's message area
  2212.        configuration information.   By  defining a message area override, you
  2213.        can change  many of the settings and security levels needed for access
  2214.        to any  particular message  area while a user is in the mail door.  If
  2215.        you move  message areas around (for example, you move area #33 to area
  2216.  
  2217.                  --------------------------------------------------
  2218.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 38
  2219.  
  2220.        #47), and you have a message area override configured for that message
  2221.        area, it may be necessary to modify the area override also.  If you do
  2222.        not define  message area  overrides,  there  will  be  no  maintenance
  2223.        necessary when moving, adding, or deleting message areas from your BBS
  2224.        configuration.
  2225.  
  2226.        Another feature  of the  message area  override editor  is the  use of
  2227.        "Forced" and  "Default" message areas.  To force a message area ON for
  2228.        all users of the mail door, you simply define a message area override.
  2229.        At the  bottom of  the Message Area Override Editor screen, there will
  2230.        be an option to set this area as "Forced".  Turning this on will cause
  2231.        this message  area to  be forced  on for  all users  who  have  enough
  2232.        security to  access the  message area.  If a user does NOT have enough
  2233.        security for access to the message area, the area will not be enabled.
  2234.  
  2235.        The same  procedure may be used to define "Default" message areas.  If
  2236.        a message  area is  configured as  a default  area, any  new user  who
  2237.        accesses the  mail door,  and who  has enough  security  to  read  the
  2238.        message area,  will find that the message area is automatically turned
  2239.        on for  them.  The difference between default message areas and forced
  2240.        message areas  is that a user CAN disable a default area, but a forced
  2241.        area cannot  be disabled  by the user.  Forced message areas remain on
  2242.        even if  a user performs an offline configuration to disable the area,
  2243.        or if  the user  tries to  modify the  messages downloaded in the area
  2244.        through the use of the Blue Wave Bundling Commands.
  2245.  
  2246.        Obviously, you  should use  discretion when  defining  forced  message
  2247.        areas.   They are best used for system announcement message areas, and
  2248.        for "private"  or EMail  message areas, where a user can only download
  2249.        messages that are directly addressed to them.
  2250.  
  2251.  
  2252.        Section 7.3.2  Removing Old User Records
  2253.  
  2254.        The only routine maintenance that should be performed on the mail door
  2255.        is the  deletion (removal)  of old  mail  door  user  records.    This
  2256.        maintenance could,  and should  be added  to your  nightly  or  weekly
  2257.        system maintenance schedule.
  2258.  
  2259.        The BWSETUP  program will remove all old user records for you.  Simply
  2260.        run "BWSETUP PURGE 30" to remove all users that have not used the mail
  2261.        door in  30 days.  Run "BWSETUP PURGE 90" to remove all users who have
  2262.        not used  the mail  door in  90 days.   The  "PURGE nn"  command  line
  2263.        parameter for  BWSETUP will  cause BWSETUP  to *not* enter interactive
  2264.        mode.  This allows you to run the purge utility in an unattended batch
  2265.        file.
  2266.  
  2267.  
  2268.        Section 7.4  Creating and Using Reader Bulletin Files
  2269.  
  2270.        The Blue Wave Mail Door has the ability to include "Welcome" or reader
  2271.        bulletin files.  When a user downloads a mail packet and loads it into
  2272.        The Blue Wave Offline Mail Reader (and other Blue Wave-compatible mail
  2273.        readers), these  bulletin  files  are  available  for  viewing  either
  2274.        automatically or  upon user  demand.  These reader files may either be
  2275.  
  2276.                  --------------------------------------------------
  2277.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 39
  2278.  
  2279.        plain ASCII  or ANSI files.  They can be used to send an advertisement
  2280.        of new  items or echos available on the BBS, or new services that your
  2281.        system offers.
  2282.  
  2283.        In the  BWSETUP program,  under the  "General Information" editor, you
  2284.        will find  five "slots",  where you can define the bulletin files that
  2285.        will be  included in  a mail  packet download.  In each of these slots
  2286.        you may  define the  file name  to be  sent, and  the minimum security
  2287.        needed in order to be able to view the file.  (If a user does not have
  2288.        sufficient security  to view one or more bulletin files, they will not
  2289.        be included  in the  mail packet.)  The file names that you place here
  2290.        must reside in the mail door's base directory.
  2291.  
  2292.        The Blue  Wave Offline  Mail Reader will behave differently, depending
  2293.        into which "slot" you have placed a reader bulletin file.  If a reader
  2294.        bulletin is  placed into  slot #1,  this bulletin will be displayed to
  2295.        the user  automatically after  opening a  mail packet.   This behavior
  2296.        cannot be  modified by the user -- think of it as a "Forced" bulletin.
  2297.        If you  place a  file name  in slot  #2 or  slot #3, the bulletin will
  2298.        automatically be  displayed if the user has enabled automatic bulletin
  2299.        display in  the mail  reader.   If the user has disabled the automatic
  2300.        bulletin display,  these files will only be viewable upon user demand.
  2301.        Slot #4 and slot #5 are always available upon user demand only.
  2302.  
  2303.        You may  use two  special macros in the reader bulletin files in order
  2304.        control their display to the user:
  2305.  
  2306.        {PAUSE} -  Place this  macro on  a line  by itself  to force  a screen
  2307.             pause.   The user  will receive  a "Press  any key  to  continue"
  2308.             message, and their screen will be cleared after pressing a key to
  2309.             continue.
  2310.  
  2311.        {BEEP} -  Sounds a beep in the mail reader, if the user has not turned
  2312.             sound off in the mail reader.
  2313.  
  2314.  
  2315.        Section 7.5  Using the Mail Door in Local Mode
  2316.  
  2317.        The Blue  Wave  Mail  Door  has  several  provisions  for  making  the
  2318.        packaging of  local mail  downloads easy  and hassle-free.  Many times
  2319.        SysOps will  opt to use The Blue Wave Offline Mail System to read mail
  2320.        locally on  their machines  at home,  or even  to pack  messages in  a
  2321.        nightly event to take to work with them.
  2322.  
  2323.        Using this method will also allow SysOps running DESQview, Windows, or
  2324.        OS/2 to read mail packets with The Blue Wave Offline Mail Reader while
  2325.        still leaving the BBS online.
  2326.  
  2327.        For this  example, we  will assume that you already have The Blue Wave
  2328.        Offline Mail Reader installed in a directory called C:\BWAVE, and that
  2329.        your DOWNLOAD directory in the mail reader configuration is defined as
  2330.        C:\BWAVE\DOWN, your  UPLOAD directory  is defined  as C:\BWAVE\UPLOAD,
  2331.        and your  WORK directory  is defined  as C:\BWAVE\WORK.   This example
  2332.        also assumes  that the  physical  computer  on  which  the  reader  is
  2333.        installed is  the same  computer that  contains your BBS and mail door
  2334.  
  2335.                  --------------------------------------------------
  2336.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 40
  2337.  
  2338.        installation.   (They may  also be  installed on  a different physical
  2339.        computer, but with the same drives accessible through a LAN.)
  2340.  
  2341.        To get  the best  results from  the interaction of the reader and mail
  2342.        door, it  is highly suggested that you set "Keep Old DL Packets (Don't
  2343.        Erase)" to "YES" in the BWSETUP->Options and Toggles Editor.
  2344.  
  2345.        The next BWSETUP configuration items you will need to edit are located
  2346.        on the  "Directories and File Paths" configuration menu.  While in the
  2347.        directories  editor,  move  the  cursor  through  the  fields  to  the
  2348.        "Temporary Work  Directory" under the "Local Mail Door Usage" section.
  2349.        You can  enter any  path here  you like, as the reader and the door do
  2350.        not  need  to  share  (and  should  not  share!)  the  temporary  work
  2351.        directories.
  2352.  
  2353.        You should then define your "Reader Download (In) Directory" to be the
  2354.        same as  the "Download  Directory" defined  in the mail reader (in our
  2355.        example, this  would be  C:\BWAVE\DOWN).   Define your  "Reader Upload
  2356.        (Out) Directory"  to be  the same as the "Upload Directory" defined in
  2357.        the mail reader (in our example, this would be C:\BWAVE\UPLOAD).
  2358.  
  2359.        Press <Esc>  to leave the Directories and File Paths editor, choose to
  2360.        exit BWSETUP,  and save your current configuration.  You are now ready
  2361.        to create two batch files.  The first batch file will execute the mail
  2362.        door in  auto-download mode (to build your mail bundle), and the other
  2363.        will execute  the door  in auto-upload mode (to send your replies back
  2364.        through the mail door).
  2365.  
  2366.        Two sample  batch files  are shown  below.  BWDOWN.BAT can be executed
  2367.        each time  you wish  to build  a mail  packet.    BWUP.BAT  should  be
  2368.        executed each time you have replied to messages in the mail reader and
  2369.        are ready  to send  them back  to the  mail door  to be processed.  In
  2370.        these sample batch files, enter the commands shown on the left side of
  2371.        the page.   Comments  on the  right side  of the  page are  there  for
  2372.        explanatory purposes only and should not be entered in the batch file.
  2373.  
  2374.  
  2375.        Sample BWDOWN.BAT
  2376.        -----------------
  2377.        c:                       Change to the drive where BWMAIL.EXE is
  2378.        cd \bbs\bluewave         Change to the directory where BWMAIL.EXE is
  2379.        bwmail /kJoe_Sysop /d    Load with "Joe Sysop" as user in Auto-DL mode
  2380.  
  2381.  
  2382.        Sample BWUP.BAT
  2383.        ---------------
  2384.        c:                       Change to the drive where BWMAIL.EXE is
  2385.        cd \bbs\bluewave         Change to the directory where BWMAIL.EXE is
  2386.        bwmail /kJoe_Sysop /u    Load with "Joe Sysop" as user in Auto-UL mode
  2387.  
  2388.  
  2389.        You should,  of course  substitute "Joe_Sysop"  with the name that you
  2390.        use to  log into  the BBS.   You  must replace all spaces in your name
  2391.        with underscore  characters (_).   In  both cases,  the mail door will
  2392.        perform the  desired function  and exit  back to  the batch file.  The
  2393.  
  2394.                  --------------------------------------------------
  2395.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 41
  2396.  
  2397.        mail door  will not  ask for  input in  local mode  when performing an
  2398.        auto-upload or auto-download.
  2399.  
  2400.  
  2401.        Section 7.6  The FidoNet->Internet Gateway
  2402.  
  2403.        The Blue  Wave Mail  Door supports  the option  of a  transparent user
  2404.        interface to  a  FidoNet->Internet  Gateway.    The  FidoNet->Internet
  2405.        Gateway menu  option in  BWSETUP allows you to configure the mail door
  2406.        to provide  a method for users to gain easy access to Internet E-mail,
  2407.        without actually requiring the BBS to be connected to the Internet.
  2408.  
  2409.        In order for this feature to work, you must be a member of FidoNet, or
  2410.        a FidoNet-style  network.   This is  due to the fact that the Internet
  2411.        gateway actually  uses a  FidoNet-style NetMail area to store messages
  2412.        that are entered through a mail reader in the Internet Gateway area.
  2413.  
  2414.        When the Internet gateway is configured and active, an Internet E-mail
  2415.        area is  created in the user's mail packet.  The user can then use the
  2416.        mail reader to create Internet E-mail messages.  When the user uploads
  2417.        the reply  packet, the  mail door  will take  these reply messages and
  2418.        convert them  to FidoNet  NetMail messages  addressed to the FidoNet<-
  2419.        >Internet gateway system you defined.
  2420.  
  2421.        Even if  your BBS  offers 'true'  Internet capabilities,  the Internet
  2422.        gateway can  be offered  alongside them,  if you  wish.   It will  not
  2423.        interfere  with   them,  as  the  Internet  gatway  uses  the  FidoNet
  2424.        capabilities of your BBS to do its work.
  2425.  
  2426.        **   Internet E-mail capabilities are available only with version 2.20
  2427.             and later  of The  Blue Wave Offline Mail Reader, and with third-
  2428.             party mail readers compatible with Version 3 or later of the Blue
  2429.             Wave mail packet specifications.
  2430.  
  2431.        For further information about each configuration item available in the
  2432.        BWSETUP FidoNet<->Internet  Gateway Editor, please press <F1> for help
  2433.        when the field you would like more help with is highlighted.
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.                  --------------------------------------------------
  2454.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 42
  2455.  
  2456.  
  2457.  
  2458.                                      ----------------------------------------
  2459.                                      Chapter 8:  SOFTWARE SUPPORT INFORMATION
  2460.                                      ----------------------------------------
  2461.  
  2462.        The Blue Wave Offline Mail System is a growing and developing software
  2463.        package.   Cutting Edge Computing is always interested in hearing your
  2464.        comments and  suggestions for  ways we  can Blue  Wave work better for
  2465.        you.  We take into consideration every request that we get in order to
  2466.        make The Blue Wave Mail System a first-class offline mail package.
  2467.  
  2468.        If you are having trouble with The Blue Wave Offline Mail Reader, Blue
  2469.        Wave Offline  Mail Door, or have comments and suggestions, please drop
  2470.        us a  line.   We can be reached through our support BBS by dialing +1-
  2471.        810-743-8464.   Our support  BBS is  online 24 hours per day, 7 days a
  2472.        week.
  2473.  
  2474.        You can  reach other  users of  The Blue  Wave Offline  Mail System to
  2475.        discuss problems  with the  software, discuss  time-saving techniques,
  2476.        and other  issues related  to your  use of the mail system through the
  2477.        BLUEWAVE echo on the FidoNet backbone.
  2478.  
  2479.        Limited technical  support is  provided by surface mail, however it is
  2480.        very difficult  to diagnose problems through a letter.  Please use the
  2481.        support BBS if at all possible.  Unregistered users of the mail reader
  2482.        need to include a self-addressed, stamped envelope if you would like a
  2483.        reply.   For inquiries  outside of the United States, you must enclose
  2484.        an International Reply Coupon (available at your local post office).
  2485.  
  2486.        Sorry, but  voice technical  support is reserved for registered owners
  2487.        of The  Blue Wave  Offline  Mail  System.    When  calling  for  voice
  2488.        technical support,  please be  sure to  have your registration numbers
  2489.        available.   Technical support  must verify  your registration  number
  2490.        before assisting  you.   Technical support  for  the  mail  system  is
  2491.        available  Monday   through  Friday  from  9am  to  3pm  Eastern  Time
  2492.        (excluding holidays).   The  technical support phone number is +1-810-
  2493.        743-WAVE (that's +1-810-743-9283).
  2494.  
  2495.        Cutting Edge  Computing is  owned and  operated by  George Hatchew  in
  2496.        Burton, Michigan, USA.  Here are our various addresses:
  2497.  
  2498.        US POSTAL SERVICE
  2499.             Cutting Edge Computing
  2500.             P.O. Box 90476
  2501.             Burton, Michigan  48509-0476  USA
  2502.  
  2503.        SUPPORT BBS
  2504.             1:2240/176          (FidoNet)
  2505.             +1-810-743-8464     (Direct Phone Number)
  2506.  
  2507.        INTERNET
  2508.             bluewave@cris.com                  (Internet Email)
  2509.             http://www.cris.com/~bluewave      (World Wide Web Site)
  2510.  
  2511.  
  2512.                  --------------------------------------------------
  2513.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 43
  2514.  
  2515.        Thank you  for trying The Blue Wave Offline Mail System.  We hope that
  2516.        the mail system provides you enjoyment and value for years to come!
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.                  --------------------------------------------------
  2572.               The Blue Wave Offline Mail Door/Maximus, v3.10;  Page 44