home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BW302_RA.ZIP / BWMAIL.DOC < prev    next >
Text File  |  1994-01-21  |  144KB  |  3,334 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.    The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  16.    Copyright (C) 1992-1994 by Cutting Edge Computing
  17.    All Rights Reserved.
  18.  
  19.    Installation and Reference Manual
  20.    Written by George Hatchew
  21.  
  22.  
  23.  
  24.    Cutting Edge Computing
  25.    PO Box 90476
  26.    Burton, Michigan  48509  USA
  27.  
  28.    BBS Support Number:  810-743-8464
  29.    FAX Support Number:  810-743-5910
  30.    Voice Tech Support:  810-743-9283  (REGISTERED USERS ONLY)
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                                  TABLE OF CONTENTS
  37.  
  38.                                  -----------------
  39.  
  40.        License Agreement .......................................  3
  41.        Registration and License Information ....................  4
  42.            Registration by FAX .................................  4
  43.            Registration by Credit Card .........................  4
  44.            Registration by Mail ................................  4
  45.        About this Documentation ................................  5
  46.        Credits .................................................  6
  47.        What is The Blue Wave Mail Door? ........................  7
  48.        Installing The Blue Wave Mail Door ......................  8
  49.        Installing The Blue Wave Mail Door Into RemoteAccess ....  9
  50.        Multi-Line Considerations ............................... 12
  51.        Command Line Parameters ................................. 13
  52.        The Blue Wave Mail Door Configuration Editor ............ 19
  53.            General Information Editor .......................... 19
  54.            The Options and Toggles Editor ...................... 22
  55.            The Directories and FilePaths Editor ................ 26
  56.            The Message Area Override Editor .................... 31
  57.            The Limits and Maximums Editor ...................... 34
  58.            The Protocol Configuration Editor ................... 37
  59.            The Archiver Definitions Editor ..................... 40
  60.                Sample Command Lines for Popular Archivers ...... 42
  61.            The Security and Netmail Manager .................... 43
  62.            The User File Editor ................................ 44
  63.        Maintaining The Blue Wave Mail Door ..................... 45
  64.            The BWUTILS PURGE Function .......................... 45
  65.        General Overview of Door Operations ..................... 46
  66.            Keys Used While a User is Online .................... 47
  67.            Carrier Checking .................................... 48
  68.            Inactivity Timer .................................... 49
  69.            Lastread Pointers ................................... 49
  70.        Offline Configurations .................................. 50
  71.        Sending Netmail Through The Blue Wave Mail Door ......... 51
  72.        File Requestion Through The Blue Wave Mail Door ......... 52
  73.        Local Mail Door Usage ................................... 53
  74.            Sample BWDOWN.BAT ................................... 54
  75.            Sample BWUP.BAT ..................................... 54
  76.        Product Suport .......................................... 55
  77.            Electronic Mail...................................... 55
  78.            FAX ................................................. 55
  79.            Voice Technical Support ............................. 55
  80.            US Mail ............................................. 55
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.               -------------------------------------------------------
  89.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  90.                                        Page 2
  91.  
  92.  
  93.  
  94.  
  95.  
  96.                                  LICENSE AGREEMENT
  97.                                  -----------------
  98.  
  99.        Cutting Edge  Computing has  taken every  precaution to ensure that no
  100.        harm or  damage will occur on systems running The Blue Wave Mail Door.
  101.        However, we  cannot be  responsible for  any damages  or other  losses
  102.        suffered as  a result  of running  The Blue  Wave Mail  Door  on  your
  103.        system.   The user  assumes full  responsibility for the proper use of
  104.        this mail  system, whether  damage occurs as a fault of operator error
  105.        or software error.  NO WARRANTIES ARE IMPLIED OR EXPRESSLY STATED.
  106.  
  107.        The Blue  Wave Mail  System  and  its  documentation  are  copyrighted
  108.        materials of  Cutting Edge Computing and George Hatchew.  Cutting Edge
  109.        Computing   reserves all  rights to  these materials, and is protected
  110.        under United  States and  International Copyright  laws.   No part  of
  111.        these materials  may be  reproduced or modified in any way without the
  112.        prior express written permission of Cutting Edge Computing.
  113.  
  114.        Use of  The Blue Wave Mail System constitutes acceptance of the stated
  115.        terms and  conditions.   Cutting Edge  Computing reserves  all  rights
  116.        which are not expressly granted.
  117.  
  118.        The Blue  Wave Mail  System is fully copyrighted, and is not, nor will
  119.        it ever  be, in  the Public  Domain.  The Blue Wave Mail System is NOT
  120.        FreeWare.   It is  distributed under  the concept of ShareWare.  Users
  121.        are allowed  to try  this program  for 30  days before  paying for and
  122.        registering the  mail system  with Cutting Edge Computing.  In this 30
  123.        days, you  may use  the program to its full capacity.  If the software
  124.        does not  meet your  needs, and  you do  not plan  on registering with
  125.        Cutting Edge  Computing after  your 30  day trial  period, you  are to
  126.        cease usage  of the  mail system.  Continued use beyond the authorized
  127.        evaluation period requires payment of the registration fee in full.
  128.  
  129.        Cutting Edge  Computing  grants  an  unlimited  license  to  make  and
  130.        distribute UNREGISTERED copies of The Blue Wave Mail System which have
  131.        been released  to the public by Cutting Edge Computing.  Absolutely no
  132.        modifications  to   the  files  contained  in  the  software  package,
  133.        including this  documentation file,  may be  made before distribution.
  134.        No fee  may be  charged by  anyone other  than Cutting  Edge Computing
  135.        beyond the  actual cost  of providing  these copies  without the prior
  136.        written consent of Cutting Edge Computing.
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.               -------------------------------------------------------
  148.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  149.                                        Page 3
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                         REGISTRATION AND LICENSE INFORMATION
  156.                         ------------------------------------
  157.  
  158.        Registered users of The Blue Wave Mail System are granted an unlimited
  159.        license to use the product, provided the following:
  160.  
  161.        Registration fees are NOT refundable.
  162.  
  163.        Registration codes are not transferable to other parties.
  164.  
  165.        Unofficial software  patches must  not be  applied, and  all copyright
  166.        notices in  the documentation  and supporting  files  are  not  to  be
  167.        altered.
  168.  
  169.        Backup copies  may be kept of all registered versions of this software
  170.        for archive purposes only.
  171.  
  172.        Use of  a registered copy is limited to one machine at a time.  Use of
  173.        multiple registered  copies on  multiple machines  requires additional
  174.        payment to Cutting Edge Computing.
  175.  
  176.  
  177.        You can register your copy of The Blue Wave Offline Mail Door and Blue
  178.        Wave Offline  Mail Reader  in several  different ways.   Cutting  Edge
  179.        Computing  accepts   credit  card   registrations  by   way  of  VISA,
  180.        MASTERCARD, and AMERICAN EXPRESS.  You may register online on The Blue
  181.        Wave Support  BBS by  calling 810-743-8464  with your  modem.  You can
  182.        also register by phone by calling 810-743-9283 voice.
  183.  
  184.        To register  by FAX,  please fill  out the  enclosed REGISTER.BW  form
  185.        completely and  FAX your  registration information to 810-743-5910, 24
  186.        hours a  day, 7  days a  week.   Fax-back registrations  and technical
  187.        support are probably the fastest ways to get your software registered.
  188.  
  189.        To register  by Check  or Money  Order, simply  fill out  the enclosed
  190.        registration form  and mail  to the  address shown.   To  register  in
  191.        EUROPE, please  see the  form REGISTER.EUR.  To register from anywhere
  192.        in the world, please see REGISTER.BW.
  193.  
  194.        Corporate and  government site  licenses are  also available.   Please
  195.        call  Cutting  Edge  Computing  (810-743-9283)  to  negotiate  a  site
  196.        license.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.               -------------------------------------------------------
  207.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  208.                                        Page 4
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                               ABOUT THIS DOCUMENTATION
  215.                               ------------------------
  216.  
  217.        The documentation  presented in  this file  is designed for sysops and
  218.        system administrators  responsible for  installing,  maintaining,  and
  219.        running The Blue Wave Offline Mail Door for RemoteAccess.
  220.  
  221.        A separate  documentation file  (BWDOOR.USE) has  been enclosed in the
  222.        distribution archive.   This file should be put online for download by
  223.        users and  clients of  The Blue  Wave Mail Door.  BWDOOR.USE describes
  224.        the functions  available in  the door, including options on the door's
  225.        CONFIGURATION menu,  selecting and  deselecting message  areas, use of
  226.        The Blue Wave Bundling Commands and general operation of the door.
  227.  
  228.        This documentation  is formatted  with Form  Feeds for printing on all
  229.        Personal Computer  printers.   This documentation file contains no IBM
  230.        Extended ASCII  characters, so  it should  print fine  on all  printer
  231.        models - even non IBM ProPrinter compatibles.
  232.  
  233.        To print this documentation in hard copy, simply execute the following
  234.        DOS command:
  235.  
  236.        COPY BWMAIL.DOC PRN
  237.  
  238.        If you  would like  to print  this documentation  using the  PRINT.COM
  239.        spooler enclosed  with most  versions  of  DOS,  simply  execute  this
  240.        command at the DOS prompt:
  241.  
  242.        PRINT BWMAIL.DOC
  243.  
  244.        The documentation  is formatted  to 60 lines per page so that printing
  245.        on laser printers should also work with no problems.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.               -------------------------------------------------------
  266.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  267.                                        Page 5
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                                       CREDITS
  274.                                       -------
  275.  
  276.        The documentation  for The  Blue Wave  Mail Door was written by George
  277.        Hatchew.   The programming  of The  Blue Wave  Mail Door  was done  by
  278.        George Hatchew.
  279.  
  280.        Cutting  Edge  Computing  would  like  to  extend  credit  to  Joaquim
  281.        Homrighausen, Andrew  Milner, Mats  Birch, and  Mats Wallin  for their
  282.        work in  creating the  JAM message base and the JAM(mbp) API, which is
  283.        used in  the code of The Blue Wave Offline Mail Door for RemoteAccess.
  284.        Use  of   the  JAM(mbp)   API  ensures   maximum  compatibility   with
  285.        RemoteAccess and the JAM message base.
  286.  
  287.        Cutting Edge  Computing would  also  like  to  extend  credit  to  the
  288.        following people  who worked  hard in  testing The Blue Wave Mail Door
  289.        for RemoteAccess.   Their  generous support  and work  has  helped  to
  290.        ensure that  you have  received the  most problem free and extensively
  291.        tested code possible.  They are listed here in alphabetical order:
  292.  
  293.        Brian Coffey
  294.        Joe & Andrea Dabrowski
  295.        Ed Deringer
  296.        David Gersic
  297.        Ben Hamilton
  298.        Dave Parker
  299.  
  300.  
  301.        The following  software is  mentioned in  this documentation,  and the
  302.        copyright information appears below:
  303.  
  304.        PKZIP/UNZIP, copyrighted by PKWare
  305.        PKARC/PKXARC, copyrighted by PKWare
  306.        ARJ, copyrighted by Robert K Jung
  307.        LHA, copyrighted by Yoshi
  308.        PAK, copyrighted by NoGate Consulting
  309.        DSZ, copyrighted by Omen Technologies
  310.        X00, copyrighted by Ray Gwinn
  311.        BNU, copyrighted by David Nugent & Unique Computing Pty Ltd
  312.        OpusCom, copyrighted by Bob Hartman
  313.        DESQview, copyrighted by Quarterdeck Software
  314.        MS-Windows, copyrighted by Microsoft
  315.        OS/2, copyrighted by International Business Machines Corporation
  316.        FrontDoor, copyrighted by Joaquim H. Homrighausen
  317.        D'Bridge, copyrighted by Chris Irwin
  318.  
  319.        This product uses the JAM(mbp) API -
  320.        Copyright 1993 Joaquim Homrighausen, Andrew Milner, Mats Birch,
  321.                       Mats Wallin.  ALL RIGHTS RESERVED.
  322.  
  323.  
  324.               -------------------------------------------------------
  325.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  326.                                        Page 6
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                           WHAT IS THE BLUE WAVE MAIL DOOR?
  333.                           --------------------------------
  334.  
  335.        The Blue Wave Mail Door is only half of a complete package.  It is the
  336.        part that  you, as  a sysop, will run online from your BBS.  Users can
  337.        then sign  into The Blue Wave Mail Door, download mail packets to read
  338.        offline, and upload replies that they have created offline.
  339.  
  340.        The Blue Wave Mail System is a complete package consisting of The Blue
  341.        Wave Mail  Door, and The Blue Wave Offline Mail Reader.  Both programs
  342.        work together to make your message bases more active.  Since users can
  343.        download their  mail in  less than one tenth of the time that it would
  344.        take them  to read it online, your system is open for more callers, or
  345.        activity in other areas of the BBS.  Users are not pushed against time
  346.        limits, and  long distance  users are not paying for the extra connect
  347.        time to the BBS.
  348.  
  349.        The advent of offline mail systems has helped amateur e-mail networks,
  350.        such as FidoNet, grow and prosper into a wealth of useful information.
  351.        Since  users   can  take   their  time  and  reply  offline  at  their
  352.        convenience, many  times their messages are more meaningful.  The Blue
  353.        Wave Mail System allows users to utilize the editor of their choice in
  354.        order to  reply to  messages.   This gives them even more comfort with
  355.        the idea of entering mail.
  356.  
  357.        The Blue  Wave Mail Door has several advantages over conventional mail
  358.        doors.    For  the  system  operator,  it  offers  a  quick  and  easy
  359.        installation procedure.   Once  the mail  door is  installed, there is
  360.        very little  or no  maintenance required!  The mail door reads most of
  361.        its settings  and control  parameters directly  out  of  your  current
  362.        RemoteAccess BBS  installation.   You never have to worry about adding
  363.        message areas  to the door's configuration, because once you add it to
  364.        the BBS,  the mail  door immediately  recognizes the new area.  If you
  365.        remove message  bases from  your  BBS  configuration,  the  door  will
  366.        recognize that, too.
  367.  
  368.        The Blue  Wave Mail  Door offers the BBS user an extremely easy to use
  369.        menu interface.   The  mail door  gives the  user more  than a  simple
  370.        interface however.   Power BBS users will find the mail door extremely
  371.        flexible, allowing  them to  custom-build mail packets containing only
  372.        the messages they wish to download.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.               -------------------------------------------------------
  384.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  385.                                        Page 7
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                          INSTALLING THE BLUE WAVE MAIL DOOR
  392.                          ----------------------------------
  393.  
  394.        This section  is meant  to provide  a quick  step-by-step installation
  395.        procedure.   If you read no further in the documentation, it is highly
  396.        suggested that  you read  this section!   If you very carefully follow
  397.        the  installation   procedures  described   below,  you  are  (almost)
  398.        guaranteed a near hassle-free installation.
  399.  
  400.             NOTE:   The Blue  Wave Mail  Door requires  that you  have a
  401.             FOSSIL driver  loaded.   Currently available  FOSSIL drivers
  402.             include X00, BNU, and OpusCom.  You should be able to find a
  403.             FOSSIL driver on a BBS that carries communications files.
  404.  
  405.        1)    UNPACK  BWMAIL.ZIP, which  is enclosed  within the  distribution
  406.             archive.   Make a  directory on  your hard drive specifically for
  407.             The Blue  Wave Mail  Door.   Making a  separate directory for The
  408.             Blue Wave  distribution files  will make  life easier in the long
  409.             run.  UnZIP BWMAIL.ZIP into your new directory (we'll call it the
  410.             BLUEWAVE directory throughout the rest of the documentation).
  411.  
  412.        2)    CHANGE  TO YOUR  BLUEWAVE directory,  and execute BWUTILS.  This
  413.             will load  the door's  INSTALLATION module, and guide you through
  414.             the initial  setup procedures.   You  will first  be prompted  to
  415.             enter the  PATH to  your RemoteAccess  v2.xx CONFIG.RA file.  You
  416.             should enter  the full  path ONLY.   If  the  door  locates  your
  417.             CONFIG.RA file,  it will find out as much information as possible
  418.             from your existing RemoteAccess setup.
  419.  
  420.        3)    EACH  MESSAGE AREA that you have defined in RemoteAccess will be
  421.             used by  the door  EXACTLY as  it is defined within RA.  The door
  422.             reads  all   message  area   definitions   directly   from   RA's
  423.             MESSAGES.DAT file.   This  includes Security  levels, area flags,
  424.             private/non-private status, etc.
  425.  
  426.        4)   AFTER A FEW SECONDS, BWUTILS will show you a screen informing you
  427.             that it  has gathered as much data as possible.  The installation
  428.             program also  installed  several  sample  archiver  and  protocol
  429.             configurations into  your  setup.    At  this  time  it  will  be
  430.             necessary to  "walk" through  EACH menu  item of the installation
  431.             and maintenance utility in order to enter information that cannot
  432.             be found  through your RemoteAccess setup.  Each menu item in the
  433.             BWUTILS program is described in detail in the section titled "THE
  434.             BWUTILS CONFIGURATION  EDITOR".   If you have questions regarding
  435.             any of  the  menu  items  you  encounter,  please  refer  to  the
  436.             appropriate section of the documentation.
  437.  
  438.        5)    AT  THIS POINT,  your new mail door has been installed.  Now you
  439.             need to  edit your  RemoteAccess configuration  files to complete
  440.             the installation process.  Please continue to the next section.
  441.  
  442.               -------------------------------------------------------
  443.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  444.                                        Page 8
  445.  
  446.  
  447.  
  448.  
  449.  
  450.                 INSTALLING THE BLUE WAVE MAIL DOOR INTO REMOTEACCESS
  451.                 ----------------------------------------------------
  452.  
  453.        If you  have installed  other external programs into your RemoteAccess
  454.        setup, you  should have absolutely no problem installing The Blue Wave
  455.        Mail Door.   If  you have  never installed external programs into your
  456.        BBS, don't worry.  This section will guide you through the process and
  457.        have you back up-and-running in no time at all.
  458.  
  459.        1)    When  you ran the BWUTILS installation module, it created a file
  460.             called BWDOOR.BAT  in your  \BLUEWAVE directory.  This batch file
  461.             was created  with the  paths  and  file  names  taken  from  your
  462.             initialization parameters,  and should  be fully  functional with
  463.             your system  (as long  as you  have not  changed anything  around
  464.             since you  executed the installation module).  If you are running
  465.             a multiline  system, this batch file will need to be edited prior
  466.             to use!
  467.  
  468.             @ECHO OFF
  469.             C:
  470.             CD \RA\BLUEWAVE
  471.             BWMAIL %1 %2 %3 %4 %5 %6 %7 %8 %9
  472.  
  473.        2)   To get RemoteAccess to supply the user with a menu item to access
  474.             The Blue  Wave Mail  Door, you will need to edit your one or more
  475.             of your  RemoteAccess system  menus using RACONFIG (or some other
  476.             RemoteAccess-Compatible Menu  Editor).   You can  place the  menu
  477.             item on any system menu you choose.  Suggested menus are the MAIN
  478.             menu and the MESSAGE menu.
  479.  
  480.             Below are TYPE 7 menu entries for single-line systems:
  481.             ------------------------------------------------------
  482.             Menu Text    :  B)lue Wave Interactive Mode
  483.             Optional Data:  *C /C C:\RA\BLUEWAVE\BWDOOR.BAT *M
  484.  
  485.             Menu Text    :  D) Quick DOWNLOAD Your Mail
  486.             Optional Data:  *C /C C:\RA\BLUEWAVE\BWDOOR.BAT /d *M
  487.  
  488.             Menu Text    :  U) Quick UPLOAD Your Replies
  489.             Optional Data:  *C /C C:\RA\BLUEWAVE\BWDOOR.BAT /u *M
  490.  
  491.  
  492.             These menu  entries for single-line systems can be used with
  493.             the default  installation batch  file, shown  above in  item
  494.             number 1.   Multi-line systems are a bit more complex, since
  495.             they require  that more  information be  passed to  the door
  496.             (Node or  Task Number,  and the NODE DIRECTORY being used by
  497.             that node).   The  next page  shows sample  menu entries for
  498.             multi-line systems.
  499.  
  500.  
  501.               -------------------------------------------------------
  502.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  503.                                        Page 9
  504.  
  505.  
  506.  
  507.  
  508.  
  509.             Below are TYPE 7 menu entries for multi-line systems:
  510.             -----------------------------------------------------
  511.             Menu Text    : B)lue Wave Interactive Mode
  512.             Optional Data: *C /C C:\RA\BLUEWAVE\BWDOOR.BAT *N *M
  513.  
  514.             Menu Text    : D) Quick DOWNLOAD Your Mail
  515.             Optional Data: *C /C C:\RA\BLUEWAVE\BWDOOR.BAT *N /d *M
  516.  
  517.             Menu Text    : U) Quick UPLOAD Your Replies
  518.             Optional Data: *C /C C:\RA\BLUEWAVE\BWDOOR.BAT *N /u *M
  519.  
  520.  
  521.             The default  BWDOOR.BAT installation  shown in item number 1
  522.             on the  previous page is not sufficient for operation of the
  523.             door in multi-line systems.  Below is a sample batch file to
  524.             use with the above menu commands.
  525.  
  526.  
  527.             BWDOOR.BAT for Multiline Systems
  528.             --------------------------------
  529.             @ECHO OFF
  530.             C:
  531.             CD\RA\BLUEWAVE
  532.             BWMAIL /t%1 /sC:\RA\NODE%1 %2 %3 %4 %5 %6 %7 %8 %9
  533.  
  534.  
  535.             In the  example batch  file and menu entries above, the NODE
  536.             number is  passed to  BWDOOR.BAT as  the first  command line
  537.             parameter (*N),  and is  used  in  BWDOOR.BAT  as  the  '%1'
  538.             replacement.   (Please see  your DOS  reference  manual  for
  539.             explanations of  the %1  - %9 parameters above if you do not
  540.             understand their use).
  541.  
  542.             The '/t%1'  command line  parameter for BWMAIL.EXE tells the
  543.             door that  it will  be running  as the  TASK or  NODE number
  544.             passed from  RemoteAccess's *N  optional data item.  THIS IS
  545.             VERY IMPORTANT TO INSURE THAT THE DOOR DOES NOT CREATE SHARE
  546.             VIOLATIONS WHEN RUNNING IN A MULTILINE SITUATION!
  547.  
  548.             In addition,  the above  batch file assumes that your system
  549.             has RemoteAccess  installed in the C:\RA directory, and that
  550.             each of  your NODE  directories  are  called  "C:\RA\NODE1",
  551.             "C:\RA\NODE2",  "C:\RA\NODE3",   etc.    In  order  to  load
  552.             properly, the  mail door needs to know in which directory to
  553.             find the  correct EXITINFO.BBS  file for  the current online
  554.             user.   This is  done with  the /S<node  dir>  command  line
  555.             parameter.   If your  distinct RemoteAccess NODE directories
  556.             are not  conveniently labeled  as above,  you will  need  to
  557.             create different batch files for each node on your BBS, with
  558.             each one specifying a different /S command line parameter.
  559.  
  560.               -------------------------------------------------------
  561.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  562.                                       Page 10
  563.  
  564.  
  565.  
  566.  
  567.  
  568.        3)   If you followed these instructions exactly,  the  mail  door
  569.             should now be ready for use.  To test your setup, simply log
  570.             into your  BBS and  select the  new menu(s)  item you placed
  571.             into the  system.    If  the  mail  door  fails  to  execute
  572.             properly,  check   the  RemoteAccess   log  file   and   the
  573.             BLUEWAVE.LOG file  for clues as to what went wrong.  You may
  574.             want to carefully go over the installation instructions once
  575.             again to make sure you didn't miss anything.
  576.  
  577.        4)    If  you are  running a  MULTI-LINE RemoteAccess  system,  please
  578.             continue on to the section titled "MULTI-LINE CONSIDERATIONS".
  579.  
  580.        5)    If you are interested in using The Blue Wave Mail Door for local
  581.             use, please read the section titled "LOCAL MAIL DOOR USAGE".
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.               -------------------------------------------------------
  620.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  621.                                       Page 11
  622.  
  623.  
  624.  
  625.  
  626.  
  627.                              MULTI-LINE CONSIDERATIONS
  628.                              -------------------------
  629.  
  630.        The Blue  Wave Offline  Mail  Door  is  fully  capable  of  multi-node
  631.        operation,  and   provides  facilities   for  ease  of  operation  and
  632.        configuration on  multi-line systems.  There are a few points that you
  633.        need to be aware of.
  634.  
  635.        All nodes  on your  system can use the same \BLUEWAVE directory.  Full
  636.        file sharing and file locking is supported.  You can use the same door
  637.        configuration file  (BWMAIL.PRM) on  all nodes  on your  system if you
  638.        like.   It is  also possible to use DIFFERENT .PRM files for each node
  639.        on your  system by  using the -C<door prm name> command line parameter
  640.        to BWMAIL.EXE.   Many  (if not  all) of  the necessary door parameters
  641.        that can  vary between nodes can be passed on the door's command line,
  642.        thereby overriding  any information  in the configuration file.  It is
  643.        highly suggested  that you  read "COMMAND  LINE PARAMETERS"  for  full
  644.        information on these command line overrides.
  645.  
  646.        It is  also important to note that all nodes must have their own WORK,
  647.        DOWNLOAD, and  UPLOAD directories.   Failure  to do  so will result in
  648.        file-name clashes between nodes if two users are using the door at the
  649.        same time.  The solution for this problem is to either use the /DOWN=,
  650.        /UPLOAD=, and  /WORK= command line parameters, or the "%T" and/or "%N"
  651.        replacement macros  in the  BWUTILS->Directories setup menu.  When the
  652.        door begins  execution, it  will replace  all occurrences  of "%T" and
  653.        "%N" with  the task  number passed  to the  door through the /t<task#>
  654.        command line parameter.
  655.  
  656.        To recap, the following problems must be avoided when running The Blue
  657.        Wave Mail Door on a multi-node system:
  658.  
  659.        1)  Each task must have its own WORK Directory.
  660.        2)  Each task must have its own DOWNLOAD Directory.
  661.        3)  Each task must have its own UPLOAD Directory.
  662.        4)  Each task must have its own SWAP Directory.
  663.        5)  Each task must have its own LOG file.
  664.  
  665.        If the  above 5  conditions are not met, your door will not perform as
  666.        expected, and you may receive SHARE violations.
  667.  
  668.        NOTE:   It is  HIGHLY recommended  that you  set  the  RA  environment
  669.        variable to  point to  your MAIN  RemoteAccess System  Directory.  The
  670.        door needs  to read  several of  RemoteAccess's configuration files in
  671.        order to  operate properly.  The mail door operates in the same way as
  672.        RA --  when it  needs a  file it first looks in the NODE directory you
  673.        passed with  the /S<Node  Dir> command  line parameter.   Then it will
  674.        look in  the directory specified by the RA environment variable.  As a
  675.        last resort, it will look in the current directory.  Your AUTOEXEC.BAT
  676.        file should contain a line reading SET RA=C:\RA for best performance.
  677.  
  678.               -------------------------------------------------------
  679.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  680.                                       Page 12
  681.  
  682.  
  683.  
  684.  
  685.                               COMMAND LINE PARAMETERS
  686.                               -----------------------
  687.  
  688.        The Blue  Wave Mail  Door accepts  several command  line parameters in
  689.        order for  you to  override certain  settings and defaults within your
  690.        BWMAIL.PRM file or defaults internal to the door.
  691.  
  692.        BWMAIL.PRM Override (-c)
  693.        ------------------------
  694.             Multi-line users may wish to maintain separate Blue Wave PRM
  695.             files, one  for each  node.   By default, the door will load
  696.             BWMAIL.PRM.   If you  use the -c command line parameter, you
  697.             can override this default.  The command line:
  698.             BWMAIL -cLINE2.PRM
  699.             would load  the door's parameter file called LINE2.PRM.  (If
  700.             you wish  to maintain  separate PRM files between nodes, you
  701.             can edit  others with  BWUtils by specifying the name of the
  702.             configuration file on the command line:  "BWUTILS LINE2.PRM"
  703.             would allow you to edit the parameters in "LINE2.PRM".
  704.  
  705.             USAGE  :  BWMAIL -c<bwave.prm name>
  706.             DEFAULT:  BWMAIL.PRM
  707.  
  708.        Node Directory Override (-s)
  709.        -----------------------
  710.             When the  door initializes,  the first file that it loads is
  711.             BWMAIL.PRM, or  the file  that you  specified on the command
  712.             line.   BWMAIL.PRM contains  the path  of  the  RemoteAccess
  713.             EXITINFO.BBS/CONFIG.RA file  that will  be loaded  when that
  714.             particular door  configuration file  is used.  (See also the
  715.             section titled MULTI-LINE CONSIDERATIONS).
  716.  
  717.             If you  would like  to override the default contained within
  718.             BWMAIL.PRM, use the command line:
  719.             BWMAIL -sC:\Ra\Node2
  720.  
  721.             USAGE  :  BWMAIL -s<Node or System Directory name>
  722.             DEFAULT:  System dir. defined in the configuration file.
  723.  
  724.        Port Override (-p)
  725.        ------------------
  726.             By default,  The Blue Wave Mail Door uses the port contained
  727.             within  the   EXITINFO.BBS  file   that  is   loaded  during
  728.             initialization.   If, for  some reason, you need to OVERRIDE
  729.             this parameter, use the -p command line.  (Port 0=COM1, Port
  730.             1=COM2, etc.).   The  door will  support any  port that  you
  731.             would like  to use,  as long as it can communicate with your
  732.             FOSSIL driver.
  733.  
  734.             USAGE  : BWMAIL -p<0-based port number>
  735.             DEFAULT: Found from EXITINFO.BBS file loaded by the door.
  736.  
  737.               -------------------------------------------------------
  738.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  739.                                       Page 13
  740.  
  741.  
  742.  
  743.  
  744.  
  745.        Task/Node Override (-t)
  746.        -----------------------
  747.             The Blue Wave Mail Door uses the default TASK number of '0'.
  748.             You must  override the  task number  used by  using the "-t"
  749.             command line parameter.  The door uses this information when
  750.             looking for the proper EXITINFO.BBS file to load, and in the
  751.             translation of  the "%N"  and "%T" macros in the Directories
  752.             and FilePaths  menu.   The task  number *must* correspond to
  753.             the user's  task number  within RemoteAccess,  or  the  door
  754.             could load  the wrong  information about the current user or
  755.             cause SHARE  violations if  task/node numbers shared between
  756.             nodes.
  757.  
  758.             RemoteAccess will  pass the current task/node number through
  759.             the use  of the  '*N' token when it is used in the "Optional
  760.             Data" line  of a  RemoteAccess system  menu.  Please see the
  761.             RemoteAccess documentation for more details.
  762.  
  763.             It is  highly recommended  that you  pass the task number to
  764.             the door whether you are running a multi-line system or not.
  765.             This will  help eliminate some confusion when setting up the
  766.             door -  especially when  running multiple copies on multiple
  767.             nodes.
  768.  
  769.             USAGE  : BWMAIL -t<task/node number>
  770.             DEFAULT: 0 (assumes no multiline operations).
  771.  
  772.  
  773.  
  774.  
  775.        Local User Override (-k)
  776.        ------------------------
  777.             Normally, The Blue Wave Mail Door can detect when there is a
  778.             local user  through the  EXITINFO.BBS file  that is  loaded.
  779.             However, if  there is  some type  of problem with the door's
  780.             auto-detection, and  you wish to run the door in local mode,
  781.             you will need to specify the -k parameter.
  782.  
  783.             The -k  can also  be used  to automatically  load a selected
  784.             user out  of RemoteAccess's  USERS.BBS file  and log them in
  785.             locally.   The best use for this is when running the door in
  786.             local mode  to bundle mail for the sysop or other users that
  787.             may want  to use  The Blue Wave Offline Mail System.  The -k
  788.             command line parameter is described in greater detail in the
  789.             section titled "LOCAL MAIL DOOR USAGE".
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.               -------------------------------------------------------
  797.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  798.                                       Page 14
  799.  
  800.  
  801.  
  802.  
  803.  
  804.        Local Color (-n)
  805.        ----------------
  806.             The Blue  Wave Mail  Door will  always output  color to  the
  807.             local screen,  even if  the remote  user  has  TTY  graphics
  808.             enabled.  Sometimes this color is not desireable, especially
  809.             on Monochrome systems.  Since the door contains so much BLUE
  810.             most of the text appears underlined.
  811.  
  812.             To disable  color output  to the  local console,  use the -N
  813.             command line  switch.   This switch  has no  effect  on  the
  814.             remote user.
  815.  
  816.             USAGE  : BWMAIL -N
  817.             DEFAULT: Local color output.
  818.  
  819.  
  820.        Carrier Detect Override (-NOCD)
  821.        -------------------------------
  822.             Normally, The  Blue Wave  Mail Door  requires that a carrier
  823.             detect signal  be present in order for the door to send data
  824.             through the  FOSSIL and  serial port.   This poses a problem
  825.             when trying  to run  the door through a NULL Modem Cable, or
  826.             something similar.
  827.  
  828.             If the command line switch -NOCD is added, no carrier detect
  829.             function will  be activated,  and data  will be sent through
  830.             the port specified with the -P<port> command line parameter.
  831.  
  832.             This switch  should NOT  be used  with a remote user online,
  833.             since the  caller may  drop carrier  and tie  up your system
  834.             until there is an input timeout (4 minutes).
  835.  
  836.             USAGE  : BWMAIL -NOCD
  837.             DEFAULT: CD is ACTIVE unless LOCAL mode forced or detected.
  838.  
  839.  
  840.        DESQview Detection Override (-NODV)
  841.        -----------------------------------
  842.             If the  door detects  that it is running under QuarterDeck's
  843.             DESQview multi-tasker,  it will automatically write directly
  844.             to DV's video buffer to eliminate screen write bleed-through
  845.             and give  away time  slices to  other tasks when the door is
  846.             idle.  To eliminate this behaviour, use the -NODV parameter.
  847.  
  848.             When DESQview support is enabled in the door, a line will be
  849.             logged to your defined LOG file, informing you of this fact.
  850.  
  851.             USAGE  : BWMAIL -NODV
  852.             DEFAULT: DESQview support used automatically if DV detected.
  853.  
  854.  
  855.               -------------------------------------------------------
  856.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  857.                                       Page 15
  858.  
  859.  
  860.  
  861.  
  862.  
  863.        Stamping Downloaded Messages as "Rec'd" (-NORECV)
  864.        -------------------------------------------------
  865.             When The Blue Wave Mail Door gathers messages for a user, it
  866.             stamps all personal messages TO: that user as "Received", to
  867.             give an  indication to  the sender that the message may have
  868.             been read.   The  -NORECV command  line parameter causes the
  869.             door to  skip the  process of  marking messages  as "Rec'd",
  870.             leaving no  indication that  the message(s)  downloaded have
  871.             been read.
  872.  
  873.             This parameter  probably should  not be  used for normal BBS
  874.             usage.   The switch may come in handy, however, if the sysop
  875.             wishes  to   download  his/her   mail,  but  not  leave  any
  876.             indication that  the message  had been read.  (The sysop may
  877.             not have  time to  reply to  the messages downloaded at that
  878.             particular time).
  879.  
  880.             USAGE  : BWMAIL -NORECV
  881.             DEFAULT: Marks personal messages as "Rec'd" when bundled.
  882.  
  883.  
  884.        Work Directory Override (-WORK=)
  885.        --------------------------------
  886.             If you  would like  to override  the default  WORK directory
  887.             defined within  BWMAIL.PRM,  use  the  -WORK=<path>  command
  888.             line.
  889.  
  890.             USAGE  : BWMAIL -WORK=d:\path\to\workdir
  891.             DEFAULT: Drive and path defined within BWMAIL.PRM
  892.  
  893.  
  894.        Download Directory Override (-DOWN=)
  895.        ------------------------------------
  896.             To override  the door's  default DOWNLOAD  directory, simply
  897.             specify the drive and path to use on the command line in the
  898.             form -DOWN=<path>.
  899.  
  900.             USAGE  : BWMAIL -DOWN=d:\path\to\downdir
  901.             DEFAULT: Directory defined within BWMAIL.PRM
  902.  
  903.  
  904.        Upload Directory Override (-UPLOAD=)
  905.        ------------------------------------
  906.             To override  the door's  default UPLOAD  directory from  the
  907.             command line, add the command line parameter -UPLOAD=<path>.
  908.  
  909.             USAGE  : BWMAIL -UPLOAD=d:\path\to\upld_dir
  910.             DEFAULT: Drive and path defined within BWMAIL.PRM
  911.  
  912.  
  913.  
  914.               -------------------------------------------------------
  915.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  916.                                       Page 16
  917.  
  918.  
  919.  
  920.  
  921.  
  922.        Log File Override (-LOG=)
  923.        -------------------------
  924.             Each copy  of The  Blue  Wave  Mail  Door  that  is  running
  925.             requires a  separate log  file.   Log files cannot be shared
  926.             between two  or more  different tasks.  This command line is
  927.             used to  override the  log file  name that is defined within
  928.             BWMAIL.PRM.   In most  cases, it would be more convenient to
  929.             use the  '%T' or  '%N' metaphor in declaring the name of the
  930.             log file within the BWUTILS Directories and Pathname Editor.
  931.             However, this  alternate way of overriding the log file name
  932.             is provided  for special  situations.   To override  the log
  933.             file name  from the door's command line, use the -LOG=<file>
  934.             parameter.
  935.  
  936.             This parameter  can also  be convenient when you do not want
  937.             to keep  a log  file for  a certain  task (usually  a  local
  938.             node).   If the  door receives  the command  line  parameter
  939.             "BWMAIL -LOG=",  no log  file will  be  generated  for  that
  940.             session.
  941.  
  942.             USAGE  : BWMAIL -LOG=d:\name\of\logfile.ext
  943.             DEFAULT: Filename defined within BWMAIL.PRM.
  944.  
  945.        WarpSpeed AutoDownload Mode (-d)
  946.        --------------------------------
  947.             The Blue Wave Mail Door has a special command line parameter
  948.             to force  the door  into download mode, then exit.  When the
  949.             door is  executed with  the  -d  parameter,  it  immediately
  950.             begins scanning the message areas and bundles a mail packet.
  951.             If there is a remote user, the door will immediately fire up
  952.             the appropriate download protocol, and then exit back to the
  953.             BBS.   If there  is no remote user, the door skips executing
  954.             the protocol,  and drops  back to  the calling  batch  file.
  955.             This is  extremely handy  for local  use in  batch files  to
  956.             possibly build  a mail  bundle during a maintenance "event".
  957.             The door  will NOT  prompt for  user input during the entire
  958.             session.
  959.  
  960.             USAGE  : BWMAIL -D
  961.             DEFAULT: The door defaults to "Interactive Menu" mode.
  962.  
  963.        AutoUpload Mode (-u)
  964.        --------------------
  965.             Specifying -U  on the  command line  will cause  the door to
  966.             immediately go  into upload  mode.  This parameter works the
  967.             same as  the AutoDownload Parameter;  the user will never be
  968.             prompted for input during the mail session.
  969.  
  970.             USAGE  : BWMAIL -U
  971.             DEFAULT: The door defaults to "Interactive Menu" mode.
  972.  
  973.               -------------------------------------------------------
  974.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  975.                                       Page 17
  976.  
  977.  
  978.  
  979.  
  980.  
  981.        Auto Logoff Mode (-LOGOFF=)
  982.        ---------------------------
  983.             This command line only has an effect on the operation of the
  984.             door when the following 2 conditions are met:
  985.  
  986.             1)  The door must be in AutoUpload or AutoDownload mode.
  987.             2)  There must be a remote user online.
  988.  
  989.             Adding the  /LOGOFF=I command  line parameter will cause the
  990.             door to  perform an  IMMEDIATE  LOGOFF  of  the  user  (drop
  991.             carrier)  after  a  successful  AutoUpload  or  AutoDownload
  992.             session.
  993.  
  994.             Adding the  /LOGOFF=C command  line parameter will cause the
  995.             door to  perform  a  COUNTDOWN  LOGOFF  of  the  user  (drop
  996.             carrier)  after  a  successful  AutoUpload  or  AutoDownload
  997.             session.
  998.  
  999.             USAGE  : BWMAIL <-D or -U> -LOGOFF=I
  1000.             USAGE  : BWMAIL <-D or -U> -LOGOFF=C
  1001.             DEFAULT: The door defaults to returning back to the BBS with
  1002.                      the remote user still online.
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.               -------------------------------------------------------
  1033.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1034.                                       Page 18
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.                     THE BLUE WAVE MAIL DOOR CONFIGURATION EDITOR
  1041.                     --------------------------------------------
  1042.                     (How to use BWUTILS.EXE to edit your setup.)
  1043.  
  1044.        After the  original initialization  and installation  of The Blue Wave
  1045.        Mail Door  is complete, you will be taken to The Blue Wave Mail Door's
  1046.        Configuration Editor.   By  default, if  BWUTILS finds a configuration
  1047.        file already  present, you will be taken directly to this menu.  If at
  1048.        any time  you wish  to re-run  the Door  Initialization module, simply
  1049.        delete the  file named BWMAIL.PRM, located in your BLUEWAVE directory.
  1050.        To make simple changes to your setup, run BWUTILS with no command line
  1051.        parameters, and  you will be taken to the configuration menu.  (If you
  1052.        would like to edit a setup besides the default "BWMAIL.PRM", enter the
  1053.        command "BWUTILS BWLINE2.PRM", or any other .PRM file name you like.
  1054.  
  1055.        A thorough  description of  each item  available for  editing  through
  1056.        BWUTILS will now be given.
  1057.  
  1058.        General Information Editor
  1059.        --------------------------
  1060.             The General  Information Editor  allows  you  to  edit  data
  1061.             regarding your  system name,  your name  as sysop, and other
  1062.             general system data.
  1063.  
  1064.             BBS NAME:
  1065.                  Enter the  name of  your BBS  here, exactly as you
  1066.                  want it to appear in the door.  Your BBS name will
  1067.                  be shown  at the  top of  the main  door menu, and
  1068.                  also to the users inside of the offline reader.
  1069.  
  1070.             YOUR REAL NAME:
  1071.                  You should enter your real name in this field.  If
  1072.                  you use a handle or alias on your BBS, this is not
  1073.                  the place  for it.  Your registration code will be
  1074.                  computed based  upon the name you give here.  Rest
  1075.                  assured that your users will NEVER see this field.
  1076.  
  1077.             YOUR NAME AS SYSOP:
  1078.                  Please enter  the name  or handle  that you use in
  1079.                  your RemoteAccess  setup to  identify yourself  to
  1080.                  your users.   When  entering mail  in the  offline
  1081.                  mail reader,  users may  enter "SYSOP"  in the TO:
  1082.                  field.   The Blue  Wave Offline  Mail Reader  will
  1083.                  insert this  name for  them, instead  of your real
  1084.                  name, since it may be different in some cases.
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.               -------------------------------------------------------
  1092.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1093.                                       Page 19
  1094.  
  1095.  
  1096.  
  1097.  
  1098.             NAME OF MAIL PACKETS CREATED BY DOOR:
  1099.                  Enter the  root name  of the mail packets that you
  1100.                  would like to use to identify your BBS.  It should
  1101.                  probably correspond  to the name of your BBS.  For
  1102.                  example:
  1103.  
  1104.                       WILDBLUE  --  The Wild! Blue BBS
  1105.                       FEDERAL   --  The Federal Post
  1106.  
  1107.                  The Blue Wave Mail Door will generate mail packets
  1108.                  using this  field as the 'root name'.  If today is
  1109.                  Monday, and  Joe User  is downloading  his  second
  1110.                  packet of  the day,  and your  Mail Packet Name is
  1111.                  IOBUS, the file generated will be named IOBUS.MO2.
  1112.                  This allows  users of  your BBS  to have  multiple
  1113.                  download packets available at one time for reading
  1114.                  from your BBS.
  1115.  
  1116.             REGISTRATION NUMBER:
  1117.                  Upon registration  of The Blue Wave Mail Door with
  1118.                  Cutting Edge  Computing, you will receive a unique
  1119.                  registration code.   Registration of The Blue Wave
  1120.                  Mail Door  not only  removes the UNREGISTERED COPY
  1121.                  on the Mail Menu, but also entitles you to special
  1122.                  utilities   and    support   NOT    available   to
  1123.                  unregistered users.   If  you have  a registration
  1124.                  number, please enter it here.
  1125.  
  1126.             DEFAULT NETWORK ADDRESS INFORMATION:
  1127.                  These four fields (Zone, Net, Node, Point) require
  1128.                  your PRIMARY  NETWORK Zone,  Net, Node,  and Point
  1129.                  number, if  you will  be using  The Blue Wave Mail
  1130.                  Door in  a FidoNet-style  application.   If you do
  1131.                  not have  a network  address, please  leave  these
  1132.                  fields as 0's.
  1133.  
  1134.                  Whenever possible,  The Blue  Wave Mail Door finds
  1135.                  the address  information  for  each  echomail  and
  1136.                  netmail area  from RA's  CONFIG.RA file.  The door
  1137.                  will  append   the  origin   line  defined  within
  1138.                  RemoteAccess  and   insert  the  network  address.
  1139.                  However,  if   it  cannot  find  the  area  within
  1140.                  MESSAGES.DAT or  the Origin  line is  blank,  this
  1141.                  default  address  will  be  used  to  address  the
  1142.                  message.
  1143.  
  1144.                  If you  are running a point system, and would like
  1145.                  to use  The Blue Wave Mail System, there should be
  1146.                  no problem.   Specify  your BOSSnode address here,
  1147.                  along with your specified point number.
  1148.  
  1149.  
  1150.               -------------------------------------------------------
  1151.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1152.                                       Page 20
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.             READER FILES:
  1159.                  Reader files  are plain  ASCII or  ANSI files that
  1160.                  will be  displayed to  the user  when they  load a
  1161.                  mail packet  downloaded from  your BBS.   You  may
  1162.                  define up  to 5  files to  be displayed.   You may
  1163.                  wish to  send files  with each  mail packet  as an
  1164.                  advertisement of  new items  or echos available on
  1165.                  the BBS,  etc.   These files  must reside  in  the
  1166.                  BLUEWAVE directory.
  1167.  
  1168.                  Along with  each reader  file, you  can  define  a
  1169.                  security level  that is  needed to  see each file.
  1170.                  If the  online user does not have enough access to
  1171.                  see the  file, it  will not be included in his/her
  1172.                  mail packet.   The  door uses  the  same  security
  1173.                  level scheme as RemoteAccess.  You can select from
  1174.                  any of  the 65535 access levels defined in RA, and
  1175.                  also any  of the  32 available  flag and  NOT flag
  1176.                  sets.
  1177.  
  1178.                  You may  use 2  special character sequences in the
  1179.                  reader  text  files  in  order  to  control  their
  1180.                  display to the user:
  1181.  
  1182.                  {PAUSE} - Inserts a "Press any key to continue"
  1183.                  {BEEP}  - Sounds a beep in the reader.
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.               -------------------------------------------------------
  1210.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1211.                                       Page 21
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.        The Options and Toggles Editor
  1218.        ----------------------------
  1219.  
  1220.             SWAP ON SHELL TO EXTERNALS:
  1221.                  If this  option is  turned on,  The Blue Wave Mail
  1222.                  Door will perform a "Memory Swap" when shelling to
  1223.                  execute the external protocols and archivers.  The
  1224.                  door will  swap all but about 3K out of memory and
  1225.                  free your  valuable RAM  for use by your archivers
  1226.                  and protocols.
  1227.  
  1228.                  If you  enable this option, please also be sure to
  1229.                  specify one of the next 3 options.
  1230.  
  1231.  
  1232.             SWAP TO EXTENDED MEMORY:
  1233.                  If this  option is  enabled, the door will attempt
  1234.                  to  swap  to  extended  memory.    If  not  enough
  1235.                  extended memory  is available, a swap to DISK will
  1236.                  be performed.
  1237.  
  1238.  
  1239.             SWAP TO EXPANDED MEMORY:
  1240.                  If this  option is  enabled, the door will attempt
  1241.                  to swap  to expanded  memory.   If not  enough LIM
  1242.                  v4.0 Expanded  Memory is available, a swap to DISK
  1243.                  will be performed.
  1244.  
  1245.  
  1246.             SWAP TO DISK:
  1247.                  If you choose to have The Blue Wave Mail Door swap
  1248.                  its used  memory to DISK, you will need about 150K
  1249.                  free on  your "Swap  Drive".   You can specify the
  1250.                  full  path  to  your  swap  directory  within  the
  1251.                  BWUTILS "Directories and Filepaths" menu editor.
  1252.  
  1253.  
  1254.             FAST (DIRECT) SCREEN WRITES:
  1255.                  If this  option is set to "Yes", the door will use
  1256.                  direct  video  writes;  diretly  to  your  monitor
  1257.                  glass.  This is by far the fastest video mode, and
  1258.                  may  be  incompatible  with  some  systems  and/or
  1259.                  multi-taskers.   If you  have trouble  with direct
  1260.                  video writes,  set this  option to "No".  The door
  1261.                  will then  use generic  BIOS screen  writes.    If
  1262.                  DESQview is  detected, the door will automatically
  1263.                  write  directly   to  the  DESQview  video  buffer
  1264.                  regardless of  what this  setting is at.  If auto-
  1265.                  DESQview detection  causes problems, use the /NODV
  1266.                  command line parameter for the door.
  1267.  
  1268.               -------------------------------------------------------
  1269.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1270.                                       Page 22
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.             ALLOW G)OODBYE COMMANDS:
  1277.                  Normally, The  Blue Wave Mail Door will give users
  1278.                  the option  of logging off your system through the
  1279.                  door [G)oodbye from the Main Menu], and the choice
  1280.                  of  an   "Instant"  or  "Countdown"  logoff  after
  1281.                  downloading a mail packet.  If you do not want the
  1282.                  users given  the ability  to automatically log off
  1283.                  after a mail transfer, or to say G)oodbye from the
  1284.                  Main Menu,  set this  option to  "No".    In  most
  1285.                  cases, however, this option should probably be set
  1286.                  to  "Yes"   in  order   to  give  users  increased
  1287.                  flexibility within the mail door.
  1288.  
  1289.  
  1290.             HANGUP ON INPUT TIMEOUT:
  1291.                  After 4  minutes  of  input  inactivity  from  the
  1292.                  remote user,  the door  normally drops carrier and
  1293.                  recycles back  to the  BBS in  order to  prevent a
  1294.                  user from  tying up  your system.   If  you do not
  1295.                  want the  door to  drop carrier  on the  user  for
  1296.                  inactivity, set  this option  to "No".    If  this
  1297.                  option is  "No", and  the  online  user  has  been
  1298.                  inactive for  more than  4 minutes,  the door will
  1299.                  simply exit  and return  control back  to the BBS,
  1300.                  rather than dropping carrier on the user.
  1301.  
  1302.  
  1303.             HANGUP ON USER WHEN TIME LIMIT EXPIRES:
  1304.                  When the  user's daily time limit has expired, the
  1305.                  door normally  drops carrier  on them  and returns
  1306.                  control to  the BBS.   However,  if you would like
  1307.                  the door  to just  exit back  to the  BBS when the
  1308.                  time limit expires, set this option to "No".
  1309.  
  1310.  
  1311.             NUKE *.NEW PACKETS AFTER LOCAL UPLOAD:
  1312.                  When The  Blue Wave  Mail Door  is used  in  local
  1313.                  mode, the  .NEW packet  generated by the reader is
  1314.                  not normally erased from the Upload directory.  If
  1315.                  you would  like the  door  to  erase  your  upload
  1316.                  packet after tossing the .NEW message replies, set
  1317.                  this option  to "Yes".   This  option only affects
  1318.                  LOCAL MODE  operations.   *.NEW packets are always
  1319.                  erased after  the door  has processed  it  with  a
  1320.                  remote user online.
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.               -------------------------------------------------------
  1328.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1329.                                       Page 23
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.             KEEP OLD DOWNLOAD PACKETS (DON'T ERASE):
  1336.                  Normally, when  The Blue  Wave Mail  Door builds a
  1337.                  mail bundle  in LOCAL mode, it erases PKTNAME.* in
  1338.                  the local  download directory, just as it does for
  1339.                  a remote user.  If you use the door in local mode,
  1340.                  and you  would like  the door  to NOT  erase other
  1341.                  mail bundles  which may  reside in  the door's and
  1342.                  reader's download  directory, set  this option  to
  1343.                  "Yes".
  1344.  
  1345.                  Another feature  that is  enabled when this option
  1346.                  is  set  to  "Yes"  is  auto-incrementing  of  the
  1347.                  download packet  extension numbers.   If  the door
  1348.                  was about  to build  a bundle called WILDBLUE.TH1,
  1349.                  and WILDBLUE.TH1  already existed  in the download
  1350.                  directory,  the   door  would   then   check   for
  1351.                  WILDBLUE.TH2.   It will  repeat this process until
  1352.                  it finds a 'hole' between .TH1 and .TH9.  If there
  1353.                  are    packets    named    WILDBLUE.TH1    through
  1354.                  WILDBLUE.TH9,  the  door  will  erase  the  oldest
  1355.                  packet and build a new one.
  1356.  
  1357.                  When using  this option  for local  mode use,  you
  1358.                  should define the DOWNLOAD directory in the reader
  1359.                  to be  the same  drive:\path as the LOCAL DOWNLOAD
  1360.                  directory in  the door's configuration menu.  This
  1361.                  way, the door will automatically archive your mail
  1362.                  packet into  the directory  the reader expects the
  1363.                  mail packet to be in.
  1364.  
  1365.  
  1366.             LOG SCANNING INFORMATION:
  1367.                  If this  option is  enabled, the  door will  write
  1368.                  into your  log file  a detailed  account  of  what
  1369.                  messages were  scanned  by  a  user  online.    It
  1370.                  includes a Keyword count, a count of NEW messages,
  1371.                  a Filter  count,  and  a  count  of  the  personal
  1372.                  messages.
  1373.  
  1374.                  All logging  done by this function will have a ":"
  1375.                  symbol preceding  the log  entry.  To toggle these
  1376.                  entries ON/OFF, press the ':' key.
  1377.  
  1378.             LOG BUNDLING INFORMATION:
  1379.                  This option is similar to the Scanning Information
  1380.                  function, except  it writes an entry for each area
  1381.                  BUNDLED.   All logging  done by this function will
  1382.                  have a  "+" symbol  preceding the  log entry.   To
  1383.                  toggle these entries ON/OFF, press the '+' key.
  1384.  
  1385.  
  1386.               -------------------------------------------------------
  1387.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1388.                                       Page 24
  1389.  
  1390.  
  1391.  
  1392.  
  1393.             LOG UPLOAD INFORMATION:
  1394.                  This  option  will  log  all  messages  that  were
  1395.                  uploaded through  The Blue  Wave Mail  Door.  With
  1396.                  this option  enabled, an  entry will  be made  for
  1397.                  each message a user uploads in a packet, including
  1398.                  information about  who the  message is  TO, who it
  1399.                  was FROM, the subject of the message, and the area
  1400.                  to which the message was tossed.
  1401.  
  1402.                  All logging  done by this function will have a "@"
  1403.                  symbol preceding  the log  entry.  To toggle these
  1404.                  entries ON/OFF, press the '@' key.
  1405.  
  1406.  
  1407.             LOG ERROR MESSAGES:
  1408.                  This option will log all errors encountered by the
  1409.                  door.  All logging done by this function will have
  1410.                  a '!'  symbol preceding  the log entry.  Press the
  1411.                  '!' key to toggle these log entries ON/OFF.
  1412.  
  1413.  
  1414.             LOG SCANNING AND BUNDLING TOTALS:
  1415.                  With this  option enabled, the door will write the
  1416.                  total number  of messages  scanned and  the  total
  1417.                  messages bundled  to the  log file.   Please  note
  1418.                  that this  is a  GRAND TOTAL.   In  order to get a
  1419.                  total number  of messages  that were  scanned  and
  1420.                  bundled by  AREA, please  see  the  previous  page
  1421.                  regarding  SCANNING   INFORMATION   and   BUNDLING
  1422.                  TOTALS.
  1423.  
  1424.                  All logging  done by this function will have a "*"
  1425.                  symbol preceding  the log  entry.  To toggle these
  1426.                  entries ON/OFF, press the '*' key.
  1427.  
  1428.  
  1429.             LOG GENERAL ACTIVITY:
  1430.                  This option  is primarily  a "catch-all" for those
  1431.                  who would  like a  log file,  but not  a  detailed
  1432.                  account of  events.   General  activity  will  log
  1433.                  things such  as "Joe  User Entering  The Blue Wave
  1434.                  Mail Door at 9600 Baud", "Scanning Message Areas",
  1435.                  and "Bundling Messages".
  1436.  
  1437.                  If you want totals and other information included,
  1438.                  please use  some of  the above  mentioned  logging
  1439.                  levels.
  1440.  
  1441.                  All logging  done by this function will have a '='
  1442.                  symbol preceding  the log  entry.  To toggle these
  1443.                  entries ON/OFF, press the '=' key.
  1444.  
  1445.               -------------------------------------------------------
  1446.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1447.                                       Page 25
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.        The Directories and FilePaths Editor
  1454.        ------------------------------------
  1455.  
  1456.             One of  the many  features of The Blue Wave Mail Door is the
  1457.             ability to  work easily  on multi-line  systems.  For all of
  1458.             the path  and file  names described below, it is possible to
  1459.             use the  '%T' and the '%N' metaphors wherever you would like
  1460.             to use the TASK number the door is running as.
  1461.  
  1462.             For example, if a system is running 2 lines, it is necessary
  1463.             to specify  different WORK, UPLOAD, and DOWNLOAD directories
  1464.             for each  line.   It is  not possible  to share  the  door's
  1465.             working directories  between 2 tasks.  To simplify the setup
  1466.             process for  multi-line setups, you may wish to declare your
  1467.             paths in the following way:
  1468.  
  1469.             DOWNLOAD Directory:  C:\Ra\Bluewave\Down%T
  1470.             UPLOAD Directory  :  C:\Ra\Bluewave\Upload%T
  1471.             WORK Directory    :  C:\Ra\Bluewave\Work%T
  1472.  
  1473.             If the  door is invoked with a '-T1' command line parameter,
  1474.             the door will search for and use the following paths:
  1475.  
  1476.             DOWNLOAD Directory:  C:\Ra\Bluewave\Down01
  1477.             UPLOAD Directory  :  C:\Ra\Bluewave\Upload01
  1478.             WORK Directory    :  C:\Ra\Bluewave\Work01
  1479.  
  1480.             The door  always expands  the %T  metaphor into  a 2  digit,
  1481.             hexadecimal number.   A  '-T12' on  the command  line  would
  1482.             expand to 'C:\Ra\Bluewave\Down0C', and so on.
  1483.  
  1484.             The %N  metaphor is  very similar to the %T metaphor, except
  1485.             that it  translates the  %N into  a 1,  2, or  3 digit  task
  1486.             number that the door is using as a DECIMAL number.  A '-T12'
  1487.             on   the    door's   command   line   would   translate   to
  1488.             'C:\Ra\Bluewave\Down12', and  a '-T1'  on the door's command
  1489.             line would translate to 'C:\Ra\Bluewave\Down1'.
  1490.  
  1491.             The task  number translations  work for not only the working
  1492.             directories, but  for EVERY  path name,  filename, and  Flag
  1493.             File name described below.
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.               -------------------------------------------------------
  1505.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1506.                                       Page 26
  1507.  
  1508.  
  1509.  
  1510.  
  1511.             Path to RemoteAccess System Directory:
  1512.                  The  Blue   Wave  Mail   Door  needs   to  load  a
  1513.                  RemoteAccess v2.xx CONFIG.RA file in order to know
  1514.                  several things  about your  system, and  the  task
  1515.                  that it  is running  under.  Please enter the full
  1516.                  path to  your RemoteAccess CONFIG.RA file that you
  1517.                  would like the door to use here.
  1518.  
  1519.                  Note:   For those  running multiple tasks, you may
  1520.                  specify the SYSTEM DIRECTORY to use on the command
  1521.                  line, if  you wish.   If you enter the name of the
  1522.                  SYSTEM DIRECTORY  on the  command  line,  it  will
  1523.                  override the  default setting that you enter here.
  1524.                  Please  see   the  section  titled  "COMMAND  LINE
  1525.                  PARAMETERS".
  1526.  
  1527.  
  1528.             Path to Hudson Msg Base Files:
  1529.                  The directory you define here is actually used for
  1530.                  two purposes.   If  you  have  any  message  areas
  1531.                  defined within  RemoteAccess as  "Hudson"  message
  1532.                  areas, the  door will  expect to  find the  Hudson
  1533.                  Message Base  Files in  this directory.  Secondly,
  1534.                  even if  you do  not use Hudson Message Bases, the
  1535.                  door   needs   to   know   what   directory   your
  1536.                  RemoteAccess USERS.BBS  file is  stored  in.    On
  1537.                  systems with  a Hudson  Message Base installation,
  1538.                  this directory  will be  the  same  for  both  the
  1539.                  message base and the user file.
  1540.  
  1541.  
  1542.             Path/Filename of Blue Wave's LOG File:
  1543.                  The Blue  Wave Mail  Door will  keep a log file of
  1544.                  all activity within the door.  You can specify the
  1545.                  name of this file here.  You need to have separate
  1546.                  LOG files  if you  are running more than one task.
  1547.                  You can  use the '%T' or '%N' metaphor, or use the
  1548.                  '-LOG=<path>' command line override when executing
  1549.                  the door  to specify  different log file names for
  1550.                  the different tasks you may be running.
  1551.  
  1552.                  If you  do not  want the  door to keep a log file,
  1553.                  simply leave  this field  blank, and  no log  file
  1554.                  will be kept.
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.               -------------------------------------------------------
  1564.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1565.                                       Page 27
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.             Path to Blue Wave's DOWNLOAD Directory:
  1572.                  Specify the  path to Blue Wave's personal DOWNLOAD
  1573.                  directory.   This is  the area  where mail packets
  1574.                  will be  compressed  into,  and  downloaded  from.
  1575.                  This  directory   is  cleaned   of  "PACKETNAME.*"
  1576.                  whenever a  user begins  to download a packet.  To
  1577.                  be safe,  you should  never  keep  files  in  this
  1578.                  directory that you want to keep.
  1579.  
  1580.                  WARNING:   Do NOT  share your  WORK directory with
  1581.                  the DOWNLOAD directory.  The door will still work,
  1582.                  but may  not  operate  correctly.    The  download
  1583.                  directory  *may*   be  shared   with  the   upload
  1584.                  directory, but again, we advise against it.
  1585.  
  1586.                  Normally, when  a user  leaves The  Blue Wave Mail
  1587.                  Door, this  directory is  cleansed of  the  packet
  1588.                  that was  made.   However, in LOCAL mode, the file
  1589.                  is kept  so that  you may  download mail  in local
  1590.                  mode and  read  the  packet  with  The  Blue  Wave
  1591.                  Offline Mail Reader.
  1592.  
  1593.  
  1594.  
  1595.             Path to Blue Wave's UPLOAD Directory:
  1596.                  The Blue  Wave Mail Door uses the UPLOAD directory
  1597.                  to accept  a user's  upload packet.  The protocols
  1598.                  will be  executed with the upload directory on the
  1599.                  command  line.    After  a  protocol  is  finished
  1600.                  executing, the door will expect to find the upload
  1601.                  packet here.
  1602.  
  1603.                  After a  remote user  is finished  with an upload,
  1604.                  this  directory   is  erased   of  "PACKETNAME.*".
  1605.                  However, after  a local  upload, this directory is
  1606.                  not cleaned,  in case  you would like to save your
  1607.                  upload packet for later use.
  1608.  
  1609.                  When the door begins an upload session, it CHANGES
  1610.                  to the  upload directory, for those protocols that
  1611.                  can only  accept uploads to the current directory.
  1612.                  This  means   that  you  must  either  store  your
  1613.                  protocol driver  in your  DOS PATH  statement,  or
  1614.                  specify the  full  path  and  file  name  to  your
  1615.                  external protocol drivers in the PROTOCOL menu.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.               -------------------------------------------------------
  1623.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1624.                                       Page 28
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.             Path to Blue Wave's WORK Directory:
  1631.                  Specify the  path pointing to Blue Wave's personal
  1632.                  WORK directory.   The  Blue Wave  Mail  Door  will
  1633.                  perform all  of its bundling and unpacking in this
  1634.                  directory.   You should  have enough free space in
  1635.                  this directory  to handle  the MAXIMUM  NUMBER  OF
  1636.                  DOWNLOADABLE MESSAGES  specified in the Limits and
  1637.                  Maximums Editor  Menu.   (This path  can lie  on a
  1638.                  different drive).
  1639.  
  1640.                  WARNING:  This directory will be COMPLETELY erased
  1641.                  whenever the  user begins  an upload  or  download
  1642.                  session.   Do NOT  point this  directory somewhere
  1643.                  where  there  are  files  that  you  do  not  want
  1644.                  deleted.
  1645.  
  1646.  
  1647.             Path to Blue Wave's SWAP File:
  1648.                  The path  you enter  here will  be where  The Blue
  1649.                  Wave Mail  Door will  write  its  SWAP  file  when
  1650.                  shelling to  an external protocol or archiver.  If
  1651.                  you do  not have swapping enabled in The Blue Wave
  1652.                  Mail Door, you do not need to specify a path here.
  1653.                  If you  told the  door to use Extended or Expanded
  1654.                  memory on  a swap, you should still specify a path
  1655.                  here,  however.    If  the  swap  to  extended  or
  1656.                  expanded memory fails, the door will automatically
  1657.                  swap to disk.
  1658.  
  1659.                  The Blue Wave Mail Door's swap file consumes about
  1660.                  150K, and  is erased  when control  returns to the
  1661.                  door.
  1662.  
  1663.                  You MUST  specify a  different swap  directory for
  1664.                  each task  that you may be running.  Two copies of
  1665.                  The Blue Wave Mail Door cannot share the same swap
  1666.                  directory.    This  is  most  easily  accomplished
  1667.                  through the  use of  the '%T' or '%N' metaphor, as
  1668.                  described at the beginning of this section.
  1669.  
  1670.  
  1671.             Local WORK Directory:
  1672.                  This directory  serves the  same  purpose  as  the
  1673.                  normal work  directory described  above, with  one
  1674.                  exception:   This directory  will be used when the
  1675.                  door is  loaded in  LOCAL mode (there is no remote
  1676.                  user).   If you  want to use the same directory in
  1677.                  LOCAL mode  as for  REMOTE mode, simply leave this
  1678.                  field blank.
  1679.  
  1680.  
  1681.               -------------------------------------------------------
  1682.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1683.                                       Page 29
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.             Local DOWNLOAD Directory:
  1690.                  This directory  serves the  same  purpose  as  the
  1691.                  normal download  directory, but  is used  when the
  1692.                  door is  in LOCAL mode.  Leave this field blank if
  1693.                  you do not want separate download directories.
  1694.  
  1695.  
  1696.             Local UPLOAD Directory:
  1697.                  Serves the  same purpose as the Local DOWNLOAD and
  1698.                  WORK directories.
  1699.  
  1700.  
  1701.        A SPECIAL NOTE ABOUT DIRECTORIES:
  1702.             The Blue  Wave Mail Door checks for the existence of each of
  1703.             the  UPLOAD,  DOWNLOAD,  and  WORK  directories  during  the
  1704.             initialization process.   If any or all of these directories
  1705.             do not  exist, the  door  attempts  to  create  them.    If,
  1706.             however, the  door is  unsuccessful in its attempt to create
  1707.             its working  directories, it will log an error and refuse to
  1708.             run.
  1709.  
  1710.             The UPLOAD, DOWNLOAD, and WORK directories can be overridden
  1711.             from the  DOS command  line.   Please see the section titled
  1712.             "COMMAND LINE PARAMETERS", earlier in the documentation.
  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.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1742.                                       Page 30
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.        The Message Area Override Editor
  1749.        --------------------------------
  1750.  
  1751.  
  1752.             The message  area override  editor is  provided in order for
  1753.             you to  have separate  read access,  write access,  and area
  1754.             descriptions  between   the  door  and  RemoteAccess.    The
  1755.             override editor  also gives  you the power to define DEFAULT
  1756.             message areas  for new  users, and to FORCE message areas on
  1757.             (the user will not be able to turn it off.)
  1758.  
  1759.             New overrides  are added to the door by pressing <INS> after
  1760.             entering the Override editor.  A scrollable "pick-list" will
  1761.             then be  displayed, and  you will  be able  to highlight the
  1762.             area definition  you would like to override.  After you have
  1763.             found the  message area  that you  would like  to create  an
  1764.             Override for,  simply highlight it and press <ENTER>.  A new
  1765.             area override  will be  created, and  you can  then edit the
  1766.             parameters described below.
  1767.  
  1768.             It should  be noted  that unused  or  unnecessary  overrides
  1769.             should not  be created,  since it  will only  take the  door
  1770.             longer to  initialize when  called from  RemoteAccess.   You
  1771.             should always  Delete message area overrides that you do not
  1772.             wish to have active.
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.                                         NOTE
  1780.                                         ----
  1781.             If you  are trying to override a message area, and it is not
  1782.             showing up when pressing <INS> to select from the pick-list,
  1783.             be sure  that the  area you  are trying  to work with has an
  1784.             Area Description  defined within RACONFIG. Areas that do not
  1785.             have an  Area Description  defined will  be skipped  by  the
  1786.             BWUtils editor and by the door itself!
  1787.  
  1788.  
  1789.             It is also necessary to define an area as an override if you
  1790.             would like  to FORCE  downloading the  area to all users, or
  1791.             have the  area active as a default for new users [which will
  1792.             be explained later in this section].
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.               -------------------------------------------------------
  1800.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1801.                                       Page 31
  1802.  
  1803.  
  1804.  
  1805.  
  1806.             Area Number:
  1807.                  BWUtils allows  you to edit the AREA NUMBER of the
  1808.                  message area.   If, for some reason you would like
  1809.                  to change the area's "number" in the door, you can
  1810.                  do it here.
  1811.  
  1812.             Area Description:
  1813.                  The more  complete description of the message area
  1814.                  should be entered here.  This will be shown to the
  1815.                  user when selecting areas for download, and in the
  1816.                  Blue  Wave  Offline  Mail  Reader  when  selecting
  1817.                  conferences to  read.   This does  not necessarily
  1818.                  have to  match the  RemoteAccess entry.   The long
  1819.                  area title can also be changed without consequence
  1820.                  to the user's downloaded areas.
  1821.  
  1822.             Area Origin Line:
  1823.                  Normally, The  Blue Wave  Mail Door will append an
  1824.                  Origin line  to messages  entering the  system  as
  1825.                  Echomail.  The origin line used is the one that is
  1826.                  defined within RemoteAccess.  If you would like to
  1827.                  override  an   area's  Origin  line,  and  have  a
  1828.                  different one  appended by  the door,  you  should
  1829.                  enter it  here.   Do NOT include the Zone:Net/Node
  1830.                  information, as  the door  will automatically  add
  1831.                  this information itself.
  1832.  
  1833.             Area Type:
  1834.                  You can  change the  type  of  messages  that  are
  1835.                  posted  in   this  message   base  between  LOCAL,
  1836.                  ECHOMAIL, and  NETMAIL, overriding  RemoteAccess's
  1837.                  definition of the area.
  1838.  
  1839.             Message Kinds:
  1840.                  You can  override RA's  operation  to  define  the
  1841.                  current message  area  as  accepting  PUBLIC  ONLY
  1842.                  messages, PRIVATE  ONLY messages,  or allowing the
  1843.                  user the  choice of  making the  message PUBLIC or
  1844.                  PRIVATE.
  1845.  
  1846.             Read Security Level:
  1847.                  Selecting this option will allow you to define the
  1848.                  Security  level   needed  to  access  (read)  this
  1849.                  particular message  area.  The Blue Wave Mail Door
  1850.                  supports all  of RA's  Security levels  and FLAGS.
  1851.                  If  you  enter  a  security  level  here  that  is
  1852.                  different than  RA's setting,  this will  OVERRIDE
  1853.                  what you  have defined  in RA.   This  is a useful
  1854.                  feature to  allow you  to define  different access
  1855.                  levels between the door and RemoteAccess itself.
  1856.  
  1857.  
  1858.               -------------------------------------------------------
  1859.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1860.                                       Page 32
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.             Write Security Level:
  1867.                  The Blue  Wave Mail  Door allows  you to  define a
  1868.                  security and  flag level  for a user to ENTER mail
  1869.                  into a  message area.   If  a user  has sufficient
  1870.                  access   to   download   a   message   area,   but
  1871.                  insufficient access  to post, the reader will give
  1872.                  them a  message that  says "This  is  a  READ-ONLY
  1873.                  Area", if  they try  to enter  a message  into the
  1874.                  area.
  1875.  
  1876.  
  1877.             *)Default Message Areas for New Users:
  1878.                  If you would like to make the current message area
  1879.                  a DEFAULT  message area  for new  users,  you  can
  1880.                  toggle the Default status by pressing the '*' key.
  1881.                  When an  area is selected as a default, it will be
  1882.                  active the  first time a new user enters the door.
  1883.                  They will  still be  able to turn the message area
  1884.                  off through  the  door's  Configuration  Menu,  or
  1885.                  through the  reader's OFFLINE  CONFIGURATION.   Of
  1886.                  course, the  area is  only automatically activated
  1887.                  if the current user has READ access to the message
  1888.                  area.
  1889.  
  1890.                  When entering  the door  for the  first time,  the
  1891.                  user is shown the default active message areas.
  1892.  
  1893.  
  1894.             !)Force Message area ON
  1895.                  Through the  use of  the Override  editor,  it  is
  1896.                  possible to  FORCE a message area ON for all users
  1897.                  who use  The Blue  Wave Mail  Door.  If an area is
  1898.                  forced on,  a user will not be able to turn it off
  1899.                  through the door's Configuration Menu, nor through
  1900.                  the use  of the  reader's OFFLINE  CONFIGURATIONS.
  1901.                  It is also impossible to modify the download count
  1902.                  in the  message area  through the  use of The Blue
  1903.                  Wave Bundling Commands.
  1904.  
  1905.                  This option  is used  to Globally  force a message
  1906.                  area.     You  can  force  message  areas  on  for
  1907.                  individual users  through the  BWUtils  User  File
  1908.                  Editor, which  will be  described  in  a  separate
  1909.                  section.
  1910.  
  1911.                  It should be noted that a message area will not be
  1912.                  forced ON unless the user online actually has READ
  1913.                  access to  the message  area.  If the user doesn't
  1914.                  have access,  they will  not even  know  that  the
  1915.                  message area exists.
  1916.  
  1917.               -------------------------------------------------------
  1918.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1919.                                       Page 33
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.        The Limits and Maximums Editor
  1926.        ------------------------------
  1927.  
  1928.             The Limits and Maximums Editor allows the sysop control over
  1929.             several aspects  of the  door's behaviour.  From this editor
  1930.             you can  define the maximum number of messages that you will
  1931.             allow a user to download at each of the supported BPS rates.
  1932.             Additionally, you  can specify  the maximum size of the mail
  1933.             packets that  you will  allow to  be created  at each of the
  1934.             specified BPS rates.
  1935.  
  1936.  
  1937.             MAX UNCOMPRESSED PACKET SIZE:
  1938.                  The maximum uncompressed packet size allows you to
  1939.                  limit the  size of  the mail packets that the door
  1940.                  creates for users.  Each supported BPS rate can be
  1941.                  configured independently of each other.
  1942.  
  1943.                  One of  the best uses of this feature is for those
  1944.                  who have limited drive space and need to make sure
  1945.                  that a  user never  tries to package a mail bundle
  1946.                  that will exceed the capacity or free space of the
  1947.                  drive.
  1948.  
  1949.                  To improve  message packing speed, you may want to
  1950.                  create a  RAMdrive  to  use  as  the  door's  WORK
  1951.                  directory.   Supposing you  have  configured  your
  1952.                  system with  a 2 megabyte RAMdrive, you would want
  1953.                  to make  sure that  any user  does not  exceed the
  1954.                  capacity of  that drive.   Therefore, you may want
  1955.                  to set the "Max Uncompressed Packet Size" for each
  1956.                  BPS rate  listed to 1800K to ensure that all files
  1957.                  packed will be available to the user.
  1958.  
  1959.                  During the  mail bundling  process, the  door will
  1960.                  immediately stop gathering messages when the files
  1961.                  in the  WORK directory  reach the size you specify
  1962.                  here.  The door will then archive the mail bundle,
  1963.                  and send it to the user (after informing them that
  1964.                  they did  not receive ALL of the mail scanned, due
  1965.                  to hitting the Sysop-defined packet size).
  1966.  
  1967.                  Each individual  user ALSO  has the ability to set
  1968.                  his or  her own  Maximum Packet  Size through  the
  1969.                  door's configuration  menu.   If the Sysop Maximum
  1970.                  Packet Size  is reached  before  the  user's,  the
  1971.                  Sysop's packet  size takes  precedence.    If  the
  1972.                  user's defined  maximum  packet  size  is  reached
  1973.                  before the sysop's, the user's maximum packet size
  1974.                  is honoured.
  1975.  
  1976.               -------------------------------------------------------
  1977.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  1978.                                       Page 34
  1979.  
  1980.  
  1981.  
  1982.  
  1983.                  The Maximum Packet Size parameter differs from the
  1984.                  "Maximum Number  of Messages"  parameter described
  1985.                  below in  that the  size limit  is enforced DURING
  1986.                  message packing.   The  Max # of Msgs parameter is
  1987.                  enforced before packing can even begin.  (The user
  1988.                  will be  forced to  trim messages from the scanned
  1989.                  message list  with the Blue Wave Bundling Commands
  1990.                  before the door will begin packing messages).
  1991.  
  1992.                  If you  do not  wish to  set a Maximum Packet Size
  1993.                  for any of the supported BPS rates, simply enter a
  1994.                  -1 in  the field when prompted for a number.  This
  1995.                  will disable  the Maximum  Packet Size  Limits for
  1996.                  that particular  BPS rate,  and leave  the  screen
  1997.                  displaying a  "(none)"  in  that  field  when  the
  1998.                  limits are being viewed.
  1999.  
  2000.  
  2001.             MAXIMUM NUMBER OF MESSAGES:
  2002.                  The sysop  may define a maximum number of messages
  2003.                  that will be allowed for users to download at each
  2004.                  of the  supported BPS  rates.  If, during the mail
  2005.                  scan, the  door announces  that more messages have
  2006.                  been prepared for download than are allowed by the
  2007.                  sysop, the  user must  trim his  or  her  download
  2008.                  using The  Blue Wave  Bundling Commands before the
  2009.                  door will begin packing messages.
  2010.  
  2011.                  If you  do not wish to enforce a maximum number of
  2012.                  messages that  users can  download, simply enter a
  2013.                  "-1" in  this field when prompted for input.  This
  2014.                  will disable  the Maximum Number of Messages check
  2015.                  for that particular BPS rate, and display "(none)"
  2016.                  on the screen when viewing the limits.
  2017.  
  2018.  
  2019.             ALLOW USERS CONFIGURATION OPTION OF NEWFILES SCAN:
  2020.                  After  building   the  user's   mail  packet   for
  2021.                  download, The  Blue Wave  Mail Door  will scan the
  2022.                  file areas  defined  in  your  RemoteAccess  setup
  2023.                  (honouring all  file area  flags,  file  area  NOT
  2024.                  flags, and  security levels)  for new  files since
  2025.                  the  user   last  performed   a  successful   mail
  2026.                  download.   If you  do not want users to have this
  2027.                  option available to them, set this option to "NO".
  2028.                  Otherwise, set this option to "YES".
  2029.  
  2030.                  When this  option is  set to  "YES", users will be
  2031.                  able to  enter the door's CONFIGURATION menu while
  2032.                  online and  select whether they wish NO file list,
  2033.                  TEXT file lists, or ANSI (color) file lists.
  2034.  
  2035.               -------------------------------------------------------
  2036.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2037.                                       Page 35
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.             LIMIT NEWFILES SCAN TO FILES LESS THAN ? DAYS OLD:
  2044.                  If a  user has  not used  the  mail  door  for  an
  2045.                  extended period  of time,  it is possible for them
  2046.                  to  receive   a  "new  file"  list  that  contains
  2047.                  hundreds of  files that  are dated  several months
  2048.                  old.
  2049.  
  2050.                  Use this  setup option  to instruct  the  door  to
  2051.                  never include  files in  the NEWFILE list that are
  2052.                  more than "x" days old.  A good number to use here
  2053.                  is anything  between 10  and 30  days, however you
  2054.                  may limit the scan to any number of days you like.
  2055.  
  2056.  
  2057.             MAXIMUM NUMBER OF FILES ALLOWED PER FILE REQUEST:
  2058.                  The Blue  Wave Mail Door and The Blue Wave Offline
  2059.                  Reader work  together to provide users easy access
  2060.                  to  files   on  your   system.    For  a  complete
  2061.                  description of  the File Requesting system, please
  2062.                  see the  section titled  "FILE REQUESTING  THROUGH
  2063.                  THE BLUE WAVE MAIL DOOR".
  2064.  
  2065.                  If you wish to disable file requesting through the
  2066.                  door  completely,  enter  a  "0"  in  this  field.
  2067.                  Otherwise, you can enter any number here between 1
  2068.                  and 10.
  2069.  
  2070.                  When file  requesting, the  door honours  all file
  2071.                  area security  levels, flags,  NOT flags,  and all
  2072.                  system DOWNLOAD  limits (both  for  Maximum  Daily
  2073.                  Download and file system ratios).
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.               -------------------------------------------------------
  2095.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2096.                                       Page 36
  2097.  
  2098.  
  2099.  
  2100.  
  2101.        The Protocol Configuration Editor
  2102.        ---------------------------------
  2103.  
  2104.             The Protocol  Configuration Editor  will allow you to define
  2105.             the protocols  that are  allowed to  be used  by users while
  2106.             downloading and uploading their mail packets.
  2107.  
  2108.             The Blue  Wave Mail  Door comes  with 8  "built-in" internal
  2109.             protocols.  These are the most widely used protocols, and in
  2110.             most cases  you will  not  need  to  define  any  "External"
  2111.             protocols.
  2112.  
  2113.             However, if  you would  like to support protocols other than
  2114.             those internal to the door, The Blue Wave Mail Door provides
  2115.             the means to do so.
  2116.  
  2117.             When you  enter the  Protocol Configuration  Editor from the
  2118.             main BWUTILS  system menu, you will see a list of protocols,
  2119.             labeled from  A to R.  The first 8 protocols are "Internal",
  2120.             and the  last 10  protocol slots are available to be defined
  2121.             as EXTERNAL PROTOCOL DRIVERS.
  2122.  
  2123.  
  2124.             DEFINING THE INTERNAL PROTOCOLS:
  2125.                  Each of  the  Internal  protocols  have  a  sysop-
  2126.                  configurable "hotkey",  or key  that will identify
  2127.                  the protocol in the door when the user attempts to
  2128.                  select a  different protocol.  This menu selection
  2129.                  key is  listed  in  the  "Hotkey"  column  of  the
  2130.                  display.
  2131.  
  2132.                  Pressing  the   letter  preceeding   the  protocol
  2133.                  description  will   toggle  the   status  of  that
  2134.                  particular protocol.   If  the protocol is ACTIVE,
  2135.                  it  will  become  "inactive"  or  unavailable  for
  2136.                  selection in the door.
  2137.  
  2138.                  If the protocol is INACTIVE, and you would like to
  2139.                  activate it,  BWUTILS will ask you to type the key
  2140.                  that  you  would  like  to  be  displayed  on  the
  2141.                  protocol configuration menu.  The protocol will be
  2142.                  made active if a valid key is pressed.
  2143.  
  2144.  
  2145.             DEFINING THE EXTERNAL PROTOCOLS:
  2146.                  The Blue Wave Mail Door allows you to define up to
  2147.                  10 "external"  protocols to be used in conjunction
  2148.                  with or in place of the internal protocols.  There
  2149.                  are many  external protocol  drivers available for
  2150.                  use, including DSZ, GSZ, Hydra, BiModem, etc.
  2151.  
  2152.  
  2153.               -------------------------------------------------------
  2154.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2155.                                       Page 37
  2156.  
  2157.  
  2158.  
  2159.  
  2160.                  Pressing the  letter corresponding  to one  of the
  2161.                  external protocol slots will cause BWUTILS to open
  2162.                  a window  with several fields that must be defined
  2163.                  in order  to  have  a  properly  working  external
  2164.                  protocol.
  2165.  
  2166.  
  2167.             PROTOCOL HOTKEY:
  2168.                  Simply type  a letter  that you  would like to use
  2169.                  for selection  of  this  protocol  on  the  door's
  2170.                  protocol selection  screen.  You should be certain
  2171.                  that no 2 protocols are given the same hotkey.  If
  2172.                  hotkeys   are    duplicated   between    protocols
  2173.                  (including the internal protocols), only the FIRST
  2174.                  one listed will be accessible by users.
  2175.  
  2176.  
  2177.             PROTOCOL DESCRIPTION:
  2178.                  Type the description of the protocol that you want
  2179.                  displayed on the door's protocol selection screen.
  2180.                  For example,  you might use "DSZ/MobyTurbo Zmodem"
  2181.                  as one of your protocol descriptions.
  2182.  
  2183.  
  2184.             SEND COMMAND:
  2185.                  Enter the  command line  that will be necessary to
  2186.                  invoke this  external protocol  for sending files.
  2187.                  If  the  protocol  driver  is  not  located  in  a
  2188.                  directory located on your DOS Path, you must enter
  2189.                  the full drive:\path\filename.exe of the driver.
  2190.  
  2191.                  Several replacement  macros are available for use.
  2192.                  Before the  door executes  the command line given,
  2193.                  the following  characters are replaced with actual
  2194.                  parameter for the online user.
  2195.  
  2196.                  %P - The com port number currently in use.
  2197.                  %B - The online users CONNECTion baud rate.
  2198.                  %F - SEND command line=path & name of file to send
  2199.                       RECV command line=path & name of file to get
  2200.                  %U - The door's UPLOAD directory, with no filename
  2201.  
  2202.                  Use the  %U  macro  for  Bi-Directional  protocols
  2203.                  (Hydra, Bimodem) that need to know the name of the
  2204.                  directory to  store files  that are uploaded while
  2205.                  the user is downloading files.  The Blue Wave Mail
  2206.                  Door  fully   supports  Bidirectional   protocols.
  2207.                  While a  user is  downloading a  mail packet, they
  2208.                  can upload their *.NEW packet with a bidirectional
  2209.                  protocol.   The door will process the reply packet
  2210.                  after the user has finished downloading.
  2211.  
  2212.               -------------------------------------------------------
  2213.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2214.                                       Page 38
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.             RECEIVE COMMAND:
  2221.                  Enter the  command line  that will be necessary to
  2222.                  invoke this external protocol for receiving files.
  2223.                  If  the  protocol  driver  is  not  located  in  a
  2224.                  directory located on your DOS Path, you must enter
  2225.                  the full drive:\path\filename.exe of the driver.
  2226.  
  2227.                  The same  replacement macros are available for the
  2228.                  RECEIVE command line as for the SEND command line.
  2229.                  Please see  the previous page for a description of
  2230.                  the replacement macros.
  2231.  
  2232.  
  2233.             BATCH PROTOCOL?:
  2234.                  If this  is a  BATCH protocol (the protocol driver
  2235.                  can accept  and send more than one file during one
  2236.                  invocation of  the driver),  enter  a  Y  in  this
  2237.                  field.     If  this   is  a  single-file-at-a-time
  2238.                  protocol (such as Xmodem and Xmodem-K), enter an N
  2239.                  in this field.
  2240.  
  2241.  
  2242.             SETTING THE DEFAULT PROTOCOL:
  2243.                  When new  users enter the door for the first time,
  2244.                  the door  assigns them  a default  protocol.  This
  2245.                  protocol should  normally be Zmodem, as almost all
  2246.                  terminal  programs  today  contain  some  sort  of
  2247.                  Zmodem transfer  capability.    If,  however,  you
  2248.                  would like  to change the default protocol, simply
  2249.                  type  "S"  while  in  the  Protocol  Configuration
  2250.                  Editor.   You will  be asked to type the letter of
  2251.                  the protocol  that you  would like assigned as the
  2252.                  default.
  2253.  
  2254.  
  2255.             EXAMPLE EXTERNAL PROTOCOL COMMAND LINE:
  2256.                  This part  of the  documentation  is  meant  as  a
  2257.                  simple guide  to installing  external protocols in
  2258.                  general.  All external protocols contain their own
  2259.                  unique  set   of  parameters   and  command   line
  2260.                  switches.   If  you  have  trouble  executing  any
  2261.                  external protocol,  please consult  THAT PROTOCOLS
  2262.                  documentation.  This examples shows how to install
  2263.                  DSZ with MobyTurbo as one of the externals:
  2264.  
  2265.                  PORT LOCKED AT 38400, SENDING:
  2266.                  c:\path\to\dsz.com port %P estimate 0 %B sz -m %F
  2267.  
  2268.                  UNLOCKED COM PORT, SENDING:
  2269.                  c:\path\to\dsz.com port %P speed %B sz -m %F
  2270.  
  2271.               -------------------------------------------------------
  2272.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2273.                                       Page 39
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.        The Archiver Definitions Editor
  2280.        -------------------------------
  2281.  
  2282.             Unlike the  protocols described in the previous section, The
  2283.             Blue Wave  Mail Door *REQUIRES* the use of external archiver
  2284.             utilities.   The door  initialization module  installed some
  2285.             sample archivers, but some editing may be necessary in order
  2286.             for the archivers to work correctly.  The archivers are used
  2287.             to compress  downloaded mail  bundles before sending them to
  2288.             the user,  and for decompressing uploaded mail bundles after
  2289.             receiving them from a user.
  2290.  
  2291.  
  2292.  
  2293.             DEFAULT ARCHIVER:
  2294.                  This  field  allows  you  to  define  the  Default
  2295.                  Archiver for new users to The Blue Wave Mail Door.
  2296.                  (A user  may later change his/her default from the
  2297.                  door's CONFIGURATION  menu.)   As with  protocols,
  2298.                  there must  always be  a default archiver defined.
  2299.                  Because of  this, if  archiver #1  is set  to  the
  2300.                  default, you  will NOT  be able to disable it.  To
  2301.                  select another archiver to be the default, move to
  2302.                  the correct definition number, and type the letter
  2303.                  "D".  Any previously marked default archivers will
  2304.                  be toggled off automatically.
  2305.  
  2306.  
  2307.  
  2308.             ARCHIVER HOTKEY:
  2309.                  This field  allows you to define the "Hotkey" used
  2310.                  to select  the current  archiver from  the  door's
  2311.                  CONFIGURATION Menu.   You should be careful not to
  2312.                  duplicate  hotkeys   between  different  archivers
  2313.                  (such as  using "Z"  for .ZIP  and "Z"  for  .ZOO,
  2314.                  both).  The letter "Q" should also not be used, as
  2315.                  this is used internally by the door for a "(Q)uit"
  2316.                  menu option.   Any  other alpha-numeric character,
  2317.                  however, is OK.
  2318.  
  2319.  
  2320.  
  2321.             ARCHIVER TITLE:
  2322.                  This is  the short, 3 letter extension used by the
  2323.                  archiver.   You should  probably make it match the
  2324.                  "standard" extension  so as  to not  confuse  your
  2325.                  users.     Examples  of  popular  archivers  would
  2326.                  include "ZIP",  "ARC", "PAK",  "LZH",  "ARJ",  and
  2327.                  "ZOO".
  2328.  
  2329.  
  2330.               -------------------------------------------------------
  2331.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2332.                                       Page 40
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.             ARCHIVER COMPRESS COMMAND LINE:
  2339.                  Here you  will define  the command  line  used  to
  2340.                  compress your  users' mail packets.  The Blue Wave
  2341.                  Mail  Door  supports  2  "metacharacters"  in  the
  2342.                  compression command  lines, and  will be described
  2343.                  below.
  2344.  
  2345.                  WARNING:   LHARC *will* hang your system if you do
  2346.                  not give  it the  proper command  line.   The door
  2347.                  uses "non-standard" filename extensions, and LHARC
  2348.                  will complain.  You must have a "/m" on your LHARC
  2349.                  compression command line.
  2350.  
  2351.  
  2352.  
  2353.             ARCHIVER DECOMPRESS COMMAND LINE:
  2354.                  Here you  will define  the command  line  used  to
  2355.                  decompress your users' uploaded mail packets.
  2356.  
  2357.                  NOTE:   It should  be mentioned that there MUST BE
  2358.                  ENOUGH MEMORY  FREE ON  YOUR  SYSTEM  TO  RUN  THE
  2359.                  EXTERNAL ARCHIVERS!   If  you are  getting "Out of
  2360.                  Memory or  Disk Space" errors, and you have plenty
  2361.                  of disk  space, you  will need  to  either  enable
  2362.                  SWAPPING within  The Blue  Wave Mail Door, or make
  2363.                  RemoteAccess swap  (*M) to the Blue Wave Mail Door
  2364.                  or exit with an errorlevel (TYPE 15 Menu Item).
  2365.  
  2366.  
  2367.  
  2368.                         Archiver Command Line Metacharacters
  2369.                         ------------------------------------
  2370.                  @F   Inserts the directory/filename of the file to
  2371.                       be BUILT  when used  in the  compress command
  2372.                       line.   When used  in the  Decompress command
  2373.                       line, the door inserts the directory/filename
  2374.                       of the file to be DECOMPRESSED.
  2375.  
  2376.                  @I    When  used in the Compress command line, the
  2377.                       door inserts  the directory  and filename  of
  2378.                       the files  to INCLUDE  in the  archive.  When
  2379.                       used in the DECOMPRESS command line, the door
  2380.                       inserts the  directory/filename of  the place
  2381.                       where the extracted files will be placed (the
  2382.                       door's WORK directory).
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.               -------------------------------------------------------
  2390.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2391.                                       Page 41
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.                      Sample Command Lines for Popular Archivers
  2398.                      ------------------------------------------
  2399.             The  following   examples  have   been  tested   with  their
  2400.             respective archivers and work well:
  2401.  
  2402.             PKZIP @F @I            ZIP Compression command line
  2403.             PKUNZIP @F @I          ZIP Decompression command line
  2404.  
  2405.             PKARC -a @F @I         ARC Compression command line
  2406.             PKXARC -e @F @I        ARC Decompression command line
  2407.  
  2408.             LHARC a /m @F @I       LZH Compression command line
  2409.             LHARC e /m @F @I       LZH Decompression command line
  2410.  
  2411.             PAK a @F @I            PAK Compression command line
  2412.             PAK e @F @I            PAK Decompression command line
  2413.  
  2414.             ARJ a -e @F @I         ARJ Compression command line
  2415.             ARJ e @F @I            ARJ Decompression command line
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.               -------------------------------------------------------
  2449.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2450.                                       Page 42
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.        The Security and Netmail Manager
  2457.        --------------------------------
  2458.  
  2459.             The Blue  Wave Mail  Door  has  full  built-in  support  for
  2460.             Fidonet netmail.  The door allows you to define the security
  2461.             level and  flags needed  to access  every BIT  on a  netmail
  2462.             message.  When the door was installed, it defaulted to SYSOP
  2463.             on all security levels.
  2464.  
  2465.             You should be careful about allowing users access to certain
  2466.             netmail  attributes.     That,  however,  is  left  at  your
  2467.             discretion.   The Blue  Wave Mail  Door simply  provides the
  2468.             capability for  users to  enter File  Request messages,  and
  2469.             other "usually sysop-only" bits.
  2470.  
  2471.             The Blue  Wave Mail  Door, however,  allows you to have even
  2472.             more control  over messages  entered in  your netmail bases.
  2473.             The door  will allow you to define the default bits to place
  2474.             on ALL  MESSAGES.   Several bits  are allowed to be toggled,
  2475.             but obviously  those that  will never be used were left out.
  2476.             (What do  you mean  you want  to mark  ALL Netmail  as  File
  2477.             Attaches??)
  2478.  
  2479.             For example,  you could  place the  HOLD bit  on all netmail
  2480.             messages so  that they can be "screened" before leaving your
  2481.             system.   The door  double checks  these flags  and security
  2482.             levels when  users upload netmail through the door, so there
  2483.             is absolutely  no chance  of  someone  "hacking"  their  way
  2484.             through the security system.
  2485.  
  2486.             For full  details on  how The  Blue Wave  Mail Door  handles
  2487.             netmail  bases,  please  see  the  section  titled  "SENDING
  2488.             NETMAIL THROUGH THE BLUE WAVE MAIL DOOR".
  2489.  
  2490.             The door uses the security listed in the Security Editor for
  2491.             sending mail  to unlisted  nodes.   Unlisted nodes are those
  2492.             that the  door could  not find in your NODELIST when doing a
  2493.             matrix-mail lookup  for the costing on a node.  If you allow
  2494.             "Normal" access  to this  option, it  is possible to run the
  2495.             door without  a nodelist.   If  a node  is unlisted, and the
  2496.             user has  proper access  to SEND to unlisted nodes, the door
  2497.             checks the "COST TO SEND TO UNLISTED NODES" field.  Then, if
  2498.             the user  has a  proper CREDIT/DEBIT ratio, the message will
  2499.             be allowed  to enter  the system.   Otherwise,  the user  is
  2500.             given an  informative message,  and the door does not accept
  2501.             the new mail into the system.
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.               -------------------------------------------------------
  2508.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2509.                                       Page 43
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.        The User File Editor
  2516.        --------------------
  2517.  
  2518.             BWUTILS contains a User File Editor, which allows you access
  2519.             to all  of the  user-configurable options  and several other
  2520.             extra items.
  2521.  
  2522.             Most  of  the  items  in  the  user  file  editor  are  self
  2523.             explanatory, so  it would  only be a waste of time and paper
  2524.             to explain  them here.  The User File editor contains an on-
  2525.             line help  screen, which is accessible by pressing F1 in the
  2526.             editor.
  2527.  
  2528.             The part  of the  user editor  that deserves  mention is the
  2529.             Area Editor.   To  see and/or  edit the areas that a user is
  2530.             currently active  for, you can press F5 to bring up a "pick-
  2531.             list".  Areas that the user has active will be tagged with a
  2532.             yellow box.
  2533.  
  2534.             To toggle the ACTIVE status on the highlighted message area,
  2535.             simply press the [Space] bar.
  2536.  
  2537.             Through the  user  area  editor,  it  is  also  possible  to
  2538.             selectively FORCE  message areas  for particular  users.  By
  2539.             pressing F9  while on  a highlighted  message  area,  it  is
  2540.             possible to  toggle the  FORCED status  of the  area for the
  2541.             current user.
  2542.  
  2543.             Forcing a  message area on a user through the user editor is
  2544.             somewhat different  than forcing an area through the Message
  2545.             Area Override  Editor, although  both serve  the same  basic
  2546.             purpose;  to disallow the user to turn OFF the active status
  2547.             either through  the door's Configuration Menu or through the
  2548.             reader's OFFLINE CONFIGURATIONS.
  2549.  
  2550.             When a  particular message  area is FORCED on a user through
  2551.             the user  file editor,  the  door  disregards  the  security
  2552.             levels when  evaluating whether or not the person has access
  2553.             to see  and/or read  the area.   If  you force  an area on a
  2554.             user, and  they do NOT have access to read the area, IT WILL
  2555.             STILL BE TAGGED AS ACCESSIBLE AND ACTIVE!
  2556.  
  2557.             This provides  a very  powerful way  to give  selected users
  2558.             access to  higher-security areas  without actually having to
  2559.             increase their  Security and Flag levels for the rest of the
  2560.             BBS.
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.               -------------------------------------------------------
  2567.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2568.                                       Page 44
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.                         MAINTAINING THE BLUE WAVE MAIL DOOR
  2575.                         -----------------------------------
  2576.  
  2577.        Careful thought  has gone  into making The Blue Wave Mail Door easy to
  2578.        maintain.   There is  nothing worse  than having  to duplicate efforts
  2579.        while adding  and deleting  message areas to and from your BBS.  After
  2580.        all, you  have already edited the RemoteAccess data files, why have to
  2581.        do it again?
  2582.  
  2583.        You don't!   Since  each time  the door loads it reads directly out of
  2584.        RA's MESSAGES.RA,  the message  area definitions are always up to date
  2585.        with RA's  setup.   The only  time message  area maintenance  would be
  2586.        required is if you use the Message Area Overrides feature of the door.
  2587.  
  2588.  
  2589.  
  2590.        The BWUTILS PURGE Function
  2591.        --------------------------
  2592.             About the  only maintenance  that may  be necessary  is  the
  2593.             deletion of  users from  the door's  user file (BWMAIL.USR).
  2594.             The Blue Wave Mail Door makes it easy to keep a 'clean' user
  2595.             file.   If you  want to  delete all users from the user file
  2596.             that have  not used  the door in 90 days, simply execute the
  2597.             command line "BWUTILS PURGE 90" from the BLUEWAVE Directory.
  2598.             The door  will automatically  pack the  user file and remove
  2599.             all inactive users.
  2600.  
  2601.             Any number may be entered for the number of days to pack the
  2602.             user file  down to,  but the BWUTILS Purge function will not
  2603.             allow the  <days> parameter  to be  less than 30.  This is a
  2604.             built-in safety  precaution against  wiping out  your entire
  2605.             Blue Wave user file.
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.               -------------------------------------------------------
  2626.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2627.                                       Page 45
  2628.  
  2629.  
  2630.  
  2631.  
  2632.                         GENERAL OVERVIEW OF DOOR OPERATIONS
  2633.                         -----------------------------------
  2634.  
  2635.        Now that  we have examined the operation of BWUTILS in detail, and you
  2636.        have gone  through the  initial installation  of the  door,  it  seems
  2637.        appropriate to  discuss (in  general terms) the operations of the door
  2638.        itself.
  2639.  
  2640.        The  Blue   Wave  Mail   Door  interfaces   with  RemoteAccess  almost
  2641.        seamlessly.   The main  bridge between  RemoteAccess and The Blue Wave
  2642.        Mail Door is the EXITINFO.BBS file.
  2643.  
  2644.        The EXITINFO.BBS  file contains  some important  information that  The
  2645.        Blue Wave Mail Door uses to initialize itself when first executed.  In
  2646.        fact, the  door will  not run at all if it cannot find an EXITINFO.BBS
  2647.        file in your RemoteAccess System Directory [unless the /K<user number>
  2648.        command line  is used.  Please see the section titled "LOCAL MAIL DOOR
  2649.        USAGE" for more information].
  2650.  
  2651.        If you  are attempting  to run  The Blue Wave Mail Door in LOCAL MODE,
  2652.        and you get a message that says "LOST CARRIER" on your screen, chances
  2653.        are that  the EXITINFO.BBS  file that  the door  is reading  does  not
  2654.        contain your  information.  To simplify the usage of the door in LOCAL
  2655.        mode, simply go to the BLUEWAVE directory and type "BWMAIL /k0", where
  2656.        the /K parameter contains the user number of the person you would like
  2657.        to run  the door  as.   "BWMAIL /K0"  would load the first user out of
  2658.        RA's USERS.BBS  (normally the  sysop), and  execute the  door in local
  2659.        mode.
  2660.  
  2661.        An alternative to the /K<user number> command line parameter is to use
  2662.        the NAME of the person to load the door for after the /K.  To load the
  2663.        door with  "Joe Smith"  as the  active user,  use: BWMAIL /Kjoe_smith.
  2664.        You must replace all <Space> characters with an underscore.
  2665.  
  2666.        Also during initialization, all 3 of the door's PRIVATE directores are
  2667.        purged of  any files  thay may  be lurking  around and  ready to cause
  2668.        trouble during  the door  operation.  For this reason, you should make
  2669.        sure  NEVER  to  store  files  in  the  private  directories  (UPLOAD,
  2670.        DOWNLOAD, and WORK) that you plan on keeping.
  2671.  
  2672.        After the door has initialized itself, and prepared for operation, the
  2673.        user will  be shown  either the file BWINTRO.TXT (if they have neither
  2674.        ANSI nor  AVATAR selected  in RemoteAccess),  or BWINTRO.ANS for those
  2675.        with graphics  enabled.  If the user has never used The Blue Wave Mail
  2676.        System  before,  they  will  then  be  shown  the  text  in  the  file
  2677.        NEWUSER.HLP, and then their default settings.  Otherwise, they will be
  2678.        taken to the Main Menu.
  2679.  
  2680.        From the  Main Menu,  a user  is able to configure their setup, upload
  2681.        new mail,  or download  their mail  packet.  Full information on using
  2682.        The Blue Wave Mail Door is contained in the file BWDOOR.USE.
  2683.  
  2684.               -------------------------------------------------------
  2685.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2686.                                       Page 46
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.        Keys Used While a User is Online
  2693.        --------------------------------
  2694.             The Blue Wave Mail Door contains several keys that you, as a
  2695.             sysop, can press while a user is online.  The door is always
  2696.             in "simultaneous  keyboard mode",  meaning that whatever you
  2697.             type on the local keyboard will also be echoed and processed
  2698.             to/for the remote user.
  2699.  
  2700.             However, there  are "Special"  key combinations  that do not
  2701.             echo to  the remote  user or  affect their input.  Before we
  2702.             discuss the  "Sysop Keys",  let's explain a little bit about
  2703.             the status bar on the bottom row of your screen.
  2704.  
  2705.             The status  bar is  not visible  to your  remote  users,  of
  2706.             course.   During normal  operation,  you  will  only  see  1
  2707.             visible line,  however, there are actually 2 lines that make
  2708.             up the  status bar display.  When you press your sysop keys,
  2709.             additional information  will fill  the "second" status line,
  2710.             just above the normal one.  This additional information will
  2711.             be cleared,  and the  status bar  updated every  10 seconds.
  2712.             Please remember that anything shown on the bottom 2 lines of
  2713.             your display is not echoed to the remote user!
  2714.  
  2715.             The <HOME> Key:
  2716.                  Anytime a user is online, you can press the <HOME>
  2717.                  key to  get help  on the  keys available  to  you.
  2718.                  They will  be displayed  on the  STATUS BAR at the
  2719.                  bottom of the screen.
  2720.  
  2721.             The <ALT-N> Key:
  2722.                  The <ALT-N>  key will display extended information
  2723.                  about the current user, including their Alias Name
  2724.                  and City.   The  information, as  with all  of the
  2725.                  sysop keys,  will be  cleared in  about 10 seconds
  2726.                  for a more "tidy" appearance.
  2727.  
  2728.             The <ALT-C> Key:
  2729.                  While a  user is online, you can press the <ALT-C>
  2730.                  key to  "chat" with  the user.  Entering chat mode
  2731.                  allows you  to interact  directly with the user at
  2732.                  the remote  end.   Each key  that you type will be
  2733.                  echoed to the remote user, and each key the remote
  2734.                  user types will be sent to your screen.
  2735.  
  2736.                  To exit  chat mode  at any  time, simply press the
  2737.                  <ESC> key.   After you exit chat mode with a user,
  2738.                  both the  remote  user's  display  and  the  local
  2739.                  display will  be repainted  with  the  information
  2740.                  that was  on the  screen at the time chat mode was
  2741.                  entered.  Color will NOT be restored, however.
  2742.  
  2743.               -------------------------------------------------------
  2744.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2745.                                       Page 47
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.             The <ALT-H> Key:
  2752.                  Made for  those users who are just plain annoying,
  2753.                  the <ALT-H>  key will  perform a disconnect (drops
  2754.                  modem DTR),  and exits  the door.  Control is then
  2755.                  returned to  the BBS.   The  BBS software will see
  2756.                  there is  no longer  a user online and recycle the
  2757.                  BBS system.
  2758.  
  2759.  
  2760.             The <ALT-D> Key:
  2761.                  The <ALT-D> key will perform a local shell to DOS.
  2762.                  Don't worry,  the remote user won't be able to see
  2763.                  what you are doing.
  2764.  
  2765.  
  2766.             The <PageUp> Key:
  2767.                  The <PageUp> key will raise the user's online time
  2768.                  for this  session by  10 minutes.  The total  time
  2769.                  remaining is  displayed on  line 1  of the  status
  2770.                  bar.
  2771.  
  2772.  
  2773.             The <UpArrow> Key:
  2774.                  The <UpArrow>  key will  raise the  current user's
  2775.                  online time by 1 minute.
  2776.  
  2777.  
  2778.             The <PageDown> Key:
  2779.                  The <PageDown>  Key will  lower the current user's
  2780.                  online time by 10 minutes.
  2781.  
  2782.  
  2783.             The <DownArrow> Key:
  2784.                  The <DownArrow> Key will lower the current user's
  2785.                  online time by 1 minute.
  2786.  
  2787.  
  2788.  
  2789.        Carrier Checking
  2790.        ----------------
  2791.             The Blue  Wave Mail  Door performs  its own  carrier  detect
  2792.             function.  If at any time a user hangs up on the system, the
  2793.             door will  detect it, clean its private diretories, and exit
  2794.             back to  the BBS.  If the door is in the process of building
  2795.             a mail  bundle, the  door will exit as soon as it is safe to
  2796.             do so.   Sometimes this may take a second or two because the
  2797.             files have  to be  flushed and  closed before  the door  can
  2798.             exit.  Do not be alarmed, if during the scanning or bundling
  2799.             process, that  it takes  a couple of seconds for the door to
  2800.             react.
  2801.  
  2802.               -------------------------------------------------------
  2803.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2804.                                       Page 48
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.        Inactivity Timer
  2811.        ----------------
  2812.             The Blue  Wave Mail  Door has  a built-in  inactivity  timer
  2813.             which will  disconnect a user after 4 minutes of inactivity,
  2814.             unless the  setting under  OPTIONS AND  TOGGLES  in  BWUTILS
  2815.             tells the door not to drop carrier on an inactive user.
  2816.  
  2817.             Twenty seconds before the automatic exit takes place, a user
  2818.             will be  given a  "second chance"  to show that he or she is
  2819.             still alive.   If  a key still is not pressed, the door will
  2820.             lower your  modem's DTR (if toggled ON) and exit back to the
  2821.             BBS.
  2822.  
  2823.             Rest assured  that by  pressing your  SYSOP KEYS  (described
  2824.             earlier), the  inactivity timer  will *not*  be reset.  If a
  2825.             user has been inactive for 3 minutes, and you happen to type
  2826.             ALT-N to  see more information about him/her, the inactivity
  2827.             timer will still be set at 3 minutes.  However, if you press
  2828.             one of  the "normal"  keys, the timer will be reset, just as
  2829.             if the remote user had entered the keystroke.
  2830.  
  2831.  
  2832.        Lastread Pointers
  2833.        -----------------
  2834.             The door  understands and  updates  RemoteAccess's  LASTREAD
  2835.             pointers for  each user.   The file LASTREAD.BBS (for Hudson
  2836.             Message Bases)  or <JAMName.JLR>  (for JAMmed message bases)
  2837.             will be  updated  with  accurate  lastread  message  pointer
  2838.             information.
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.               -------------------------------------------------------
  2862.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2863.                                       Page 49
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.                                OFFLINE CONFIGURATIONS
  2870.                                ----------------------
  2871.  
  2872.        The Blue  Wave Mail  System contains  a built-in Offline configuration
  2873.        function.   There is absolutely nothing to configure for this function
  2874.        to operate  properly within  The Blue  Wave Mail  Door.  Everything is
  2875.        automatic.
  2876.  
  2877.        When a  user wants  to perform  an offline  configuration, all  of the
  2878.        information is  entered through  the reader.   The next time that they
  2879.        sign onto  the BBS  and upload their mail packet through The Blue Wave
  2880.        Mail Door, the door will process their offline configuration.
  2881.  
  2882.        Through the  reader's offline  configuration menu,  users are  able to
  2883.        change everything  about their door setup, except for the selection of
  2884.        protocols and archivers.  Even message areas can be toggled on and off
  2885.        through offline configurations!
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.               -------------------------------------------------------
  2921.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2922.                                       Page 50
  2923.  
  2924.  
  2925.  
  2926.  
  2927.                   SENDING NETMAIL THROUGH THE BLUE WAVE MAIL DOOR
  2928.                   -----------------------------------------------
  2929.  
  2930.        The Blue  Wave Mail  Door fully  supports Fidonet  netmail.   Both the
  2931.        reader and  the door  have full  netmail capabilities, and can address
  2932.        mail FROM  Point systems,  TO Point systems, and even handle mail from
  2933.        one zone to another!
  2934.  
  2935.        It  has   already  been  described  how  you  can  edit  your  netmail
  2936.        configuration through  the BWUtils  Security/Netmail Editor.  For each
  2937.        netmail "bit"  that the  user has  access to,  they will  be given the
  2938.        option to toggle it when entering netmail through the reader.
  2939.  
  2940.        Extended attach  flags, used  by  FrontDoor  and  D'Bridge,  are  also
  2941.        supported.   The DIRECT  and IMM(ediate) flags are used to control the
  2942.        handling of  your netmail.   If  you are  using a mailer that does not
  2943.        understand these extended flags (a ^AFLAGS line), then you may want to
  2944.        set these bits to "hidden" so that you don't have to deal with them.
  2945.  
  2946.        If netmail  is uploaded  through The  Blue Wave  Mail  Door  which  is
  2947.        destined for  another Zone, the door writes the proper ^AINTL: line to
  2948.        handle the  routing of  the mail.   To  determine whether  or not  the
  2949.        netmail is  destined for  another zone, the door compares your DEFAULT
  2950.        network address  (zone) to  the destination  zone of  the message.  If
  2951.        they are different, the ^AINTL: line is written.
  2952.  
  2953.        The Blue  Wave Mail  Door also  respects  user's  Matrix  Credits  and
  2954.        Debits.   Netmail cost  is handled  the same way as the BBS.  The door
  2955.        looks up  the cost  for each  netmail message  through a RemoteAccess-
  2956.        compiled nodelist  (You must  use  RANODE.EXE  to  compile  the  index
  2957.        files).  If you do not use RANODE.EXE to compile the nodelist indexes,
  2958.        the door will report that all netmail sent is "UNLISTED".
  2959.  
  2960.        If a  user has  enough credits  to send a netmail message, the message
  2961.        will be tossed, and the user's debits will be added to.  The resulting
  2962.        balance information  will be  written back  to EXITINFO.BBS,  so  that
  2963.        RemoteAccess can properly update the user record.
  2964.  
  2965.        If a  node is  unlisted, or The Blue Wave Mail Door cannot access your
  2966.        nodelist, it  acts accordingly.  It checks the security level to "Send
  2967.        Unlisted Mail", and also uses the cost that you have defined for "Cost
  2968.        for Unlisted Nodes" in your BWMAIL.PRM file.  If the node is unlisted,
  2969.        the message  will only  be accepted  if the  user has enough access to
  2970.        send to  unlisted nodes, and the user has enough credits to his or her
  2971.        name.
  2972.  
  2973.        Each netmail  message uploaded will be logged to your log file (if you
  2974.        have enabled  the UPLOAD INFORMATION logging (@)).  The log entry will
  2975.        contain the  cost information  and the  destination  of  the  uploaded
  2976.        message.  Obviously, you should be cautious about the people you allow
  2977.        to have access to the Netmail area.
  2978.  
  2979.               -------------------------------------------------------
  2980.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  2981.                                       Page 51
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.                   FILE REQUESTING THROUGH THE BLUE WAVE MAIL DOOR
  2988.                   -----------------------------------------------
  2989.  
  2990.        The Blue  Wave Mail Door allows users to download files from your BBS,
  2991.        if you  have enabled the option to do so.  If you do not want the file
  2992.        request function  to be active, you can set the "Maximum File Requests
  2993.        per Session"  to 0.   Otherwise,  The Blue  Wave Mail Door will accept
  2994.        them.
  2995.  
  2996.        When a  user requests that a file be sent with his or her mail packet,
  2997.        the door  performs all  necessary checks to be sure that they actually
  2998.        have access  to download  the file,  and  that  their  upload/download
  2999.        ratio, if active, is in balance.
  3000.  
  3001.        Any files  that are  requested are  logged to your log file.  The door
  3002.        also updates  a user's  DOWNLOAD K  and Total Download K for each file
  3003.        request made.   In  order for RemoteAccess to properly update the user
  3004.        record, information  is written back to EXITINFO.BBS telling RA of the
  3005.        new download statistics for the user.
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.               -------------------------------------------------------
  3039.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  3040.                                       Page 52
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.                                LOCAL MAIL DOOR USAGE
  3047.                                ---------------------
  3048.  
  3049.        The Blue  Wave  Mail  Door  has  several  provisions  for  making  the
  3050.        packaging of  local mail  downloads easy  and hassle-free.  Many times
  3051.        sysops will  opt to use The Blue Wave Offline Mail System to read mail
  3052.        locally on  their machines  at home,  or even  to pack  messages in  a
  3053.        nightly event to take to work with them.
  3054.  
  3055.        Using this method will also allow sysops running DESQview, Windows, or
  3056.        OS/2 to read mail packets with The Blue Wave Offline Mail Reader while
  3057.        still leaving the BBS online.
  3058.  
  3059.        For this  example, we  will assume that you already have The Blue Wave
  3060.        Offline Mail Reader installed in a directory called C:\BWAVE, and that
  3061.        your DOWNLOAD  directory is  defined  as  C:\BWAVE\DOWN,  your  UPLOAD
  3062.        directory is  defined as  C:\BWAVE\UPLOAD, and  your WORK directory is
  3063.        defined as C:\BWAVE\WORK.  This example also assumes that the physical
  3064.        computer that  has the  reader installed  on it also contains your BBS
  3065.        and mail door installed on it.  (Or, different physical computers, but
  3066.        with the same drives accessible through a LAN).
  3067.  
  3068.        To get  the best  results from  the interaction of the reader and mail
  3069.        door, it  is highly suggested that you set "Keep Old DL Packets (Don't
  3070.        Erase)" set  to "YES".  This switch is located on the BWUTILS "Options
  3071.        and Toggles" editor.
  3072.  
  3073.        The next BWUTILS configuration items you will need to edit are located
  3074.        on  the   "Directories  and  FilePaths"  menu  item.    While  in  the
  3075.        directories editor,  cursor through  the fields  to the  PATH TO LOCAL
  3076.        WORK DIRECTORY  field.   You can  enter any path here you like, as the
  3077.        reader and the door do not need to share WORK directories.
  3078.  
  3079.        You should then define your PATH TO LOCAL DOWNLOAD DIRECTORY to be the
  3080.        same "Download  Directory" defined  in the reader (in our example this
  3081.        would be  C:\BWAVE\DOWN).   Define your PATH TO LOCAL UPLOAD DIRECTORY
  3082.        to be the same as the "Upload Directory" defined in the reader (in our
  3083.        example this would be C:\BWAVE\UPLOAD).
  3084.  
  3085.        Press F10 to save your configuration, choose to exit BWUTILS, and save
  3086.        your current  configuration.   You are  now ready  to set up two batch
  3087.        files.   One batch file will execute the door in autodownload mode (to
  3088.        build your  mail bundle)  and the  other will execute the door in auto
  3089.        upload mode (to send your replies back through the mail door).
  3090.  
  3091.        Two sample  batch files are shown on the next page.  BWDOWN.BAT can be
  3092.        executed each  time you  wish to build a mail bundle.  BWUP.BAT should
  3093.        be executed  each time  you have replied to messages in the reader and
  3094.        are ready to send them back to the mail door to be processed.
  3095.  
  3096.  
  3097.               -------------------------------------------------------
  3098.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  3099.                                       Page 53
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.        In the  sample batch files below, enter the commands shown on the left
  3106.        side of  the page.   Comments  on the right side of the page are there
  3107.        for explanatory  purposes only  and should not be entered in the batch
  3108.        file.
  3109.  
  3110.        Sample BWDOWN.BAT
  3111.        -----------------
  3112.        c:                           Change to the drive where BWMAIL.EXE is.
  3113.        cd \ra\bluewave              Change to the directory where BWMAIL is.
  3114.        bwmail /kJoe_Sysop /d        Load with "Joe Sysop" as user in DL mode
  3115.  
  3116.  
  3117.        Sample BWUP.BAT
  3118.        ---------------
  3119.        c:                           Change to the drive where BWMAIL.EXE is.
  3120.        cd \ra\bluewave              Change to the directory where BWMAIL is.
  3121.        bwmail /kJoe_Sysop /u        Load with "Joe Sysop" as user in UL mode
  3122.  
  3123.  
  3124.        You should,  of course,  substitute "Joe_Sysop" with the name that you
  3125.        use to  log into  the BBS  with.   In both  cases, the  mail door will
  3126.        perform the  desired function  and exit  back to  the batch file.  The
  3127.        door will not ask for input in local auto upload or autodownload mode.
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.               -------------------------------------------------------
  3157.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  3158.                                       Page 54
  3159.  
  3160.  
  3161.  
  3162.  
  3163.                                   PRODUCT SUPPORT
  3164.                                   ---------------
  3165.        The Blue  Wave Mail  System  is  a  growing  and  developing  software
  3166.        package.   Cutting Edge Computing is always interested in hearing your
  3167.        comments, complaints,  suggestions, and of course kind words.  We take
  3168.        into consideration every request that we get in order to make The Blue
  3169.        Wave Mail System a first class offline mail package.  We would like to
  3170.        hear from you!
  3171.  
  3172.        If you  are having trouble with The Blue Wave Offline Mail Reader, The
  3173.        Blue Wave  Offline Mail Door, or have comments and suggestions, please
  3174.        drop us a line.  We can be reached via direct FidoNet NETMAIL, through
  3175.        the International BLUEWAVE Echo (available on the FidoNet Backbone and
  3176.        distribution hubs), and of course through the US Mail.
  3177.  
  3178.        Cutting Edge  Computing is  owned and  operated by  George Hatchew  in
  3179.        Burton, Michigan   USA.   Here are the addresses where you may contact
  3180.        me directly:
  3181.  
  3182.        Electronic Mail (methods for REGISTERED and UNREGISTERED users)
  3183.        ---------------------------------------------------------------
  3184.        FidoNet             Netmail to 1:2240/176, or the BLUEWAVE Fido Echo
  3185.        Internet            george.hatchew@f176.n2240.z1.fidonet.org
  3186.        Internet            bwave@aol.com
  3187.        America Online      Name: BWAVE
  3188.        Support BBS         The Wild! Blue BBS (1200-14400 v32b/HST)
  3189.                            810-743-8464
  3190.  
  3191.        FAX
  3192.        ---
  3193.        Faxes may  be sent  to 810-743-5910,  24 hours per day, 7 days a week.
  3194.        If you  are a  REGISTERED  USER,  please  indicate  this  on  any  Fax
  3195.        communications for  a speedier  response.  Unregistered user technical
  3196.        support via  Fax will  be honoured  at the  earliest available moment.
  3197.        However,  registered   user  support   and  other   commitments   take
  3198.        precedence.  Please provide return FAX phone number and hours.
  3199.  
  3200.        Voice Technical Support
  3201.        -----------------------
  3202.        Voice technical  support is  offered ONLY  to registered  users of The
  3203.        Blue Wave  Mail System.  Please have your name (as you registered with
  3204.        us) and  your registration  code ready  before calling.    If  at  all
  3205.        possible, please be at or near your computer when requesting technical
  3206.        assistance via  telephone.   Voice technical support is offered Monday
  3207.        through Friday at 810-743-WAVE (810-743-9283).
  3208.  
  3209.        US Mail
  3210.        -------
  3211.        Cutting Edge Computing
  3212.        PO Box 90476
  3213.        Burton, Michigan  48509  (USA)
  3214.  
  3215.               -------------------------------------------------------
  3216.               The Blue Wave Offline Mail Door for RemoteAccess, v3.02
  3217.                                       Page 55
  3218.  
  3219.  
  3220.  
  3221.                                INDEX OF KEYWORDS
  3222.                                -----------------
  3223.  
  3224.    %B   38                                BWINTRO.TXT   46
  3225.    %F   38                                BWMAIL.PRM Override   13
  3226.    %N   14, 17, 26, 27                    BWMAIL.ZIP   8
  3227.    %P   38                                BWUP.BAT   53
  3228.    %T   14, 17, 26, 27                    BWUTILS Purge function   45
  3229.    %U   38                                BWUTILS.EXE   19
  3230.    *N   14                                Carrier detect   48
  3231.    -c   13                                Carrier Detect Override   15
  3232.    -d   17                                Chat mode   47
  3233.    -DOWN=   16                            Command line parameters   13
  3234.    -k   14                                Configuration file   19
  3235.    -LOG=   17                             Copyright information   6
  3236.    -LOGOFF=   18                          Cost for Unlisted Nodes   51
  3237.    -n   15                                COUNTDOWN LOGOFF   18
  3238.    -NOCD   15                             Credits   6
  3239.    -NODV   15                             Credit card registrations   4
  3240.    -NORECV   16                           Cutting Edge Computing   3, 55
  3241.    -p   13                                Default archiver   40
  3242.    -s   13                                Default message areas   31, 33
  3243.    -t   14                                Default netword address   20
  3244.    -u   17                                Default protocol   39
  3245.    -UPLOAD=   16                          DESQview   22
  3246.    -WORK=   16                            DESQview Detection Override   15
  3247.    @F   41                                Disconnect   48
  3248.    @I   41                                DOS PATH   28
  3249.    ^AFLAGS   51                           Download Directory   12, 28
  3250.    {BEEP}   21                            Download Directory Override   16
  3251.    {PAUSE}   21                           DSZ   38, 39
  3252.    Allow G)oodbye Commands   23           EXITINFO.BBS   46
  3253.    American Express   4                   Expanded memory   22
  3254.    ARC   42                               Extended memory   22
  3255.    Archiver Compress Command   41         External protocol drivers   37
  3256.    Archiver Decompress Command   41       Fast (Direct) screen writes   22
  3257.    Archivers   40                         FAX   4, 55
  3258.    Area Description   32                  File Requests   36, 52
  3259.    Area Number   32                       File sharing   12
  3260.    Area Origin Line   32                  Force message areas   31, 34, 44
  3261.    Area Type   33                         General information editor   19
  3262.    ARJ   42                               Hangup on input timeout   23
  3263.    Auto Logoff Mode   18                  Hangup when time limit expires   23
  3264.    AutoDownload Mode   17                 Hydra   38
  3265.    AutoUpload Mode   17                   Inactivity timer   23, 49
  3266.    Batch Protocols   39                   Install    8
  3267.    BBS Name   19                          Installation instructions   8, 11
  3268.    Bidirectional protocols   38           Instant logoff  18, 23
  3269.    Bimodem   38                           Internal protocols   37
  3270.    BLUEWAVE Echo   55                     Keep old download packets   24, 53
  3271.    BWDOOR.BAT   9                         Lastread pointers   49
  3272.    BWDOOR.USE   5                         LHARC   41
  3273.    BWDOWN.BAT   53                        LIMIT NEWFILES SCAN   36
  3274.    BWINTRO.ANS   46                       Limits and Maximums   34
  3275.  
  3276.  
  3277.  
  3278.  
  3279.                                INDEX OF KEYWORDS
  3280.                                -----------------
  3281.  
  3282.    Local color   15                       Port override   13
  3283.    Local download directory   30          Protocol configuration editor   37
  3284.    Local mail door usage   11             Protocol description   38
  3285.    Local mail downloads   53              Protocol driver   28
  3286.    Local mode   23, 24, 46                Protocols   37, 38, 39
  3287.    Local upload directory   30            Purge user file   45
  3288.    Local user override   14               RAMdrive   34
  3289.    Local work directory   29              Read security level   32
  3290.    Log bundling information   24          Reader files   21
  3291.    Log error messages   25                Receive command   39
  3292.    Log file   17, 25, 27                  Register by FAX   4
  3293.    Log file override   17                 Register in EUROPE   4
  3294.    Log general activity   25              Registration codes   4
  3295.    Log scan and bundle totals  25         Registration fees   4
  3296.    Log scanning information   24          Registration form   4
  3297.    Log upload information   25            Registration number   20
  3298.    Lost carrier   46                      Send command   38
  3299.    LZH   42                               SHARE violations   12
  3300.    Maintenance   45                       ShareWare   3
  3301.    MasterCard   4                         Shell to DOS   48
  3302.    Matrix Credits   51                    Speed   34
  3303.    Max uncompressed packet size   34      Stamp Downloaded Msg as "Rec'd"   16
  3304.    Maximum file requests   52             Status bar   47
  3305.    Maximum number of messages   35        Support BBS   55
  3306.    Memory swappint   22                   Swap directory   12
  3307.    Message area override   31             Swap file   29
  3308.    Message kinds                          Swap on shell to externals   22
  3309.    Monochrome systems   15                Swap to disk   22
  3310.    Multiline systems   11, 12, 14, 26, 27 Swap to expanded memory   22
  3311.    Name of packets created by door    20  Swap to extended memory   22
  3312.    Netmail   43, 51                       Sysop keys   47
  3313.    Netmail attributes   43                Task number   14
  3314.    Netmail configuration   51             Task/Node Override   14
  3315.    Newfiles scan   35                     Time limit   23
  3316.    NEWUSER.HLP   46                       Upload Directory   12, 28
  3317.    Node Directory Override   13           Upload Directory Override   16
  3318.    Nodelist   43                          User area editor   44
  3319.    Nuke packets after local upload   23   User file editor   44
  3320.    Offline configuration   50             Visa   4
  3321.    Origin line   32                       Voice technical support   55
  3322.    Out of memory   41                     Work directory   12, 29
  3323.    PAK   42                               Work directory override   16
  3324.    Path to BW's DOWNLOAD Directory   28   Write security level   33
  3325.    Path to BW's SWAP File   29            Your name as sysop   19
  3326.    Path to BW's UPLOAD Directory   28     Your real name   19
  3327.    Path to BW's WORK Directory   29       ZIP   42
  3328.    Path to Hudson Msg Base Files   27
  3329.    Path to local DOWNLOAD Directory   53
  3330.    PATH TO LOCAL UPLOAD DIRECTORY   53
  3331.    PATH TO LOCAL WORK DIRECTORY   53
  3332.    Path to RA System Directory   27
  3333.    Path/Filename of BW's LOG File   27
  3334.