home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mail / mplus351.zip / MAILMGR.DOC < prev    next >
Text File  |  1994-01-27  |  298KB  |  5,587 lines
  1.  
  2.  
  3.  
  4.     
  5.     
  6.     
  7.     
  8.     
  9.     
  10.     
  11.     
  12.     ┌───────────────────────────────────────────────────────────────────────┐
  13.     │                                                                       │
  14.     │ ▒▒▒▄▄▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄    A QWK-compatible mail door for RBBS-PC   │ █
  15.     │ ▒▒█▒▒█▒▒█ ▒▒█▀▒▒█ ▒▒█ ▒▒█   Copyright (C) 1991-93 Newark Connections  │ █
  16.     │ ▒▒█ ▀▀▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▒▒█     Copyright (C) 1993-94 Makai Software    │ █
  17.     │ ▒▒█   ▒▒█ ▒▒█▀▒▒█ ▒▒█ ▒▒█              All rights reserved            │ █
  18.     │ ▒▒█   ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒▄                                         │ █
  19.     │  ▀▀    ▀▀  ▀▀  ▀▀  ▀▀  ▀▀▀▀▀▀         Version 3.51, January 27, 1994  │ █
  20.     │                                                                       │ █
  21.     │           ▒▒▒▄▄▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▄▄ ▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ │ █
  22.     │           ▒▒█▒▒█▒▒█ ▒▒█▀▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▒▒█ ▒▒█▀▀▀▀ ▒▒█▀▀▀▀ ▒▒█▀▒▒█ │ █
  23.     │           ▒▒█ ▀▀▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█ ▒▒▒▒▒▒█ ▒▒█▒▒▒▄ ▒▒▒▒▒▄  ▒▒▒▒▒█▀ │ █
  24.     │           ▒▒█   ▒▒█ ▒▒█▀▒▒█ ▒▒█   ▒▒█ ▒▒█▀▒▒█ ▒▒█ ▒▒█ ▒▒█▀▀▀  ▒▒█▀▒▒▄ │ █
  25.     │           ▒▒█   ▒▒█ ▒▒█ ▒▒█ ▒▒█   ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒█ ▒▒▒▒▒▒▄ ▒▒█ ▒▒█ │ █
  26.     │            ▀▀    ▀▀  ▀▀  ▀▀  ▀▀    ▀▀  ▀▀  ▀▀  ▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀  ▀▀ │ █
  27.     │                                                                       │ █
  28.     │                              ▒▒▒▒▒▒▄ ▒▒▄     ▒▒▄ ▒▒▄ ▒▒▒▒▒▒▄          │ █
  29.     │                        ▒▒▄   ▒▒█▀▒▒█ ▒▒█     ▒▒█ ▒▒█ ▒▒█▀▀▀▀   ▒▒▄    │ █
  30.     │ Makai Software       ▒▒▒▒▒▒▄ ▒▒▒▒▒▒█ ▒▒█     ▒▒█ ▒▒█ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄  │ █
  31.     │ 870 Golden Drive       ▒▒█▀▀ ▒▒█▀▀▀▀ ▒▒█     ▒▒█ ▒▒█  ▀▀▀▒▒█   ▒▒█▀▀  │ █
  32.     │ Newark, OH 43055        ▀▀   ▒▒█     ▒▒▒▒▒▒▄ ▒▒▒▒▒▒█ ▒▒▒▒▒▒█    ▀▀    │ █
  33.     │                               ▀▀      ▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀▀▀▀▀          │ █
  34.     │                                                                       │ █
  35.     └───────────────────────────────────────────────────────────────────────┘ █
  36.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  37.     
  38.     
  39.         "Go gently among the messages and comments that have been left and
  40.         remember what peace there may be in silence."
  41.     
  42.         "...Be proud of those whose company you keep -- all those that are
  43.         running or have ever run RBBS-PC."
  44.     
  45.         "...Be careful.  Strive to be happy and enjoy......."
  46.     
  47.                                                             Tom Mack
  48.                                                             July 28, 1986
  49.     
  50.  
  51.      TABLE OF CONTENTS                                               - Page i -
  52.      
  53.  
  54.          GENERAL INFORMATION                                        1
  55.              An Introduction to Mail Manager +Plus+                 1
  56.              Warranty, Distribution, and Registration               2
  57.              Registration Form                                      4
  58.              Features and Limitations                               5
  59.              Checklist of Requirements                              7
  60.          
  61.          INSTALLING MAIL MANAGER +PLUS+                             8
  62.              ** Before you begin, READ THIS! **                     8
  63.              Upgrading from a previous version                      9
  64.              First time installation                               11
  65.              Locked BPS rates                                      14
  66.              Command line options                                  15
  67.              Planning your user interface                          18
  68.              Sysop-configurable text files                         21
  69.              Text files for FIDO/netmail areas                     25
  70.          
  71.          CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)             27
  72.              Screen #1 (General configuration #1)                  29
  73.              Screen #2 (General configuration #2)                  33
  74.              Screen #3 (General Configuration #3)                  38
  75.              Screen #4 (Conference selection)                      40
  76.              Screen #4 (Conference parameters)                     41
  77.              Multiple configuration files                          49
  78.          
  79.          FIDO-STYLE *.MSG MESSAGE AREAS                            50
  80.              An introduction to FIDO format                        50
  81.              Setting up FIDO conferences                           51
  82.              Netmail areas                                         54
  83.              Netmail messages within reply packets                 57
  84.              Additional thoughts                                   60
  85.          
  86.          MISCELLANEOUS CONSIDERATIONS                              61
  87.              Debugging your setup and running in local mode        61
  88.              DORINFOx.DEF                                          62
  89.              Handling non-standard port addresses via MAILMGR.PRO  65
  90.              DESQview, OS/2, networks, and multiple nodes          67
  91.              Using a FOSSIL                                        70
  92.              QWK networking                                        71
  93.              Compressing the executable files                      71
  94.              Security features of Mail Manager +Plus+              72
  95.              Additional features                                   74
  96.          
  97.          UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+         77
  98.              CFG2TXT & TXT2CFG - binary <-> text utilities         78
  99.              MAILFIX, RBBS msg base maint. utility                 82
  100.              MMINDEX, indexing utility for *.MSG areas             85
  101.              MMGRNODE, node list compiler                          86
  102.              MNET, QWK network QWK->REP conversion utility         87
  103.              MUSER, editor for MAILMGR.USR user file               88
  104.              UPDATE and UPDATUSR, upgrade utilities                90
  105.          
  106.  
  107.     TABLE OF CONTENTS                                               - Page ii -
  108.      
  109.  
  110.          MENU COMMANDS                                             91
  111.              Main menu                                             91
  112.                  C - Configure Mail Manager                        91
  113.                  D - Download new mail                             91
  114.                  E = Expedite!                                     92
  115.                  G - Goodbye                                       92
  116.                  Q - Quit                                          92
  117.                  H (or ?) - Display help file                      92
  118.                  I - Sysop information                             92
  119.                  R - Read messages                                 93
  120.                  P - Post a message                                93
  121.                  U - Upload replies                                93
  122.                  W - Who's online?                                 94
  123.                  X - Expert toggle                                 94
  124.              Configuration menu                                    95
  125.                  A - Conference selection                          96
  126.                  X - Message selection                             97
  127.                  B - Q)WK or T)ext format                          97
  128.                  C - Mark msgs addressed to ALL as personal        98
  129.                  D - Extract personal mail ONLY                    98
  130.                  E - Extract messages written by you               98
  131.                  F - Abort packet if no new messages               98
  132.                  G - Send updated bulletins                        98
  133.                  H - Send new file listings                        98
  134.                  I - Ask before sending packet                     98
  135.                  J - File compression method                       98
  136.                  K - File transfer protocol                        99
  137.                  L - Update high message numbers after downloading 99
  138.                  M - Update high message numbers after R)eading    99
  139.                  N - Max messages per packet/conference            99
  140.                  T - Toggle 'turbokeys'                            99
  141.                  ? - Display help file                             99
  142.                  Q - Quit (finished configuring)                   99
  143.  
  144.          APPENDICES
  145.              Appendix A: Common problems                          100
  146.              Appendix B: Contacting the authors                   104
  147.              Appendix C: Acknowledgements                         105
  148.              Appendix D: File formats                             106
  149.              Appendix E: About this document                      111
  150.  
  151.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 1 -
  152.  
  153.  
  154.          INTRODUCTION
  155.          ------------
  156.  
  157.          The 'QWK' format, developed by Mark "Sparky" Herring, has been around
  158.          for some time now, and is intended as a standardized way to transfer
  159.          mail, news, and bulletins between your bulletin board and your users.
  160.  
  161.          Mail Manager was conceived as a way to handle RBBS-PC message bases
  162.          offline, via this 'QWK' format used by popular mail readers such as
  163.          SLMR, JABBER, OFFLINE, OLX, and many others.
  164.  
  165.          This type of mail transfer is normally a four-step process:
  166.  
  167.               1) The user calls your BBS, opens the QWK-style mail door, and
  168.                  downloads a *.QWK mail packet.
  169.  
  170.               2) After logging off the BBS, the any of the many QWK-compatible
  171.                  offline mail programs may be used to read and reply to
  172.                  messages in the downloaded mail packets.  The reader packs any
  173.                  replies written by the user into a reply packet.
  174.  
  175.               3) The user call yours BBS back up, opens the QWK-style mail
  176.                  door, and uploads the reply packet (*.REP).
  177.  
  178.               4) The QWK-style mail door then processes the reply packet, and
  179.                  inserts the new messages into the proper message base(s).
  180.  
  181.          Having experienced this marvelous system on other bbs types, we
  182.          searched for such a system for RBBS-PC.  None seemed to be available
  183.          out there at that time, so it looked like we'd just have to write one
  184.          ourselves.
  185.  
  186.          We acknowledge that there are at least five QWK mail doors for RBBS-PC
  187.          message bases:
  188.  
  189.                 JIMMER by Jim Goodenough,        (Shareware)
  190.                 TQM by Tom Collins,              (Shareware)
  191.                 Silver Express by Hector Santos  (Shareware)
  192.                 our original Mail Manager, and   (Free)
  193.                 Mail Manager +Plus+              (Shareware)
  194.  
  195.          One of these packages should be able to handle your QWK needs.
  196.          Naturally, we're hoping that you choose Mail Manager +Plus+!
  197.  
  198.          JIMMER popped up during development of Mail Manager's initial release,
  199.          and TQM followed a few months after Mail Manager's first release, and
  200.          Silver Express now supports the QWK format.
  201.  
  202.          Mail Manager +Plus+ is our continuing effort to add additional
  203.          features to the original basic Mail Manager package.  Mail Manager and
  204.          Mail Manager +Plus+ have been in nearly continuous development since
  205.          January of 1991, and they are by far the largest projects that either
  206.          of us have ever tackled, or are ever likely to!
  207.  
  208.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 2 -
  209.  
  210.  
  211.          WARRANTY, DISTRIBUTION, & REGISTRATION
  212.          --------------------------------------
  213.          
  214.          Mail Manager +Plus+ is NOT guaranteed in any way, shape, or form.
  215.          Although we have worked very hard to keep our door compatible with a
  216.          wide variety of possible RBBS configurations, we are forced to deal
  217.          with two very important aspects of your RBBS-PC: your USERS files, and
  218.          your MESSAGES files.  While it works just fine here, there may be
  219.          differences in your setup that can cause problems.  THEREFORE:
  220.          
  221.                     RUN MAIL MANAGER +PLUS+ AT YOUR OWN RISK!
  222.          
  223.          The Mail Manager +Plus+ package (MPLUS351.ZIP) may be distributed
  224.          freely (in unmodified form) to friends, associates, and bulletin
  225.          boards.  Re-archiving into your favorite format (ARJ, LZH, etc) is
  226.          permitted, provided that the entire package (and all documentation) is
  227.          included in the re-archiving process, and no files are modified or
  228.          added.  If you received this package in some other format than
  229.          MPLUS351.ZIP, or the .ZIP file does not have -AV verification from
  230.          Chip Morrow or Doug Wilson, then you did not receive an original copy.
  231.          Please see Appendix B for information about where you may obtain Mail
  232.          Manager +Plus+ in its official release form.
  233.          
  234.          If you are a registered user of our door, do *NOT* distribute the
  235.          registration code that you received from us.  This is your own
  236.          personal registration, and is not for distribution.
  237.          
  238.          If you are a shareware distributor/dealer, you may distribute Mail
  239.          Manager +Plus+ provided you make it clear that any fees paid to you do
  240.          NOT constitute paying for the use of the program.
  241.          
  242.          ----------------------------------------------------------------
  243.          
  244.          Mail Manager +Plus+ is a fully-functional SHAREWARE package.
  245.          
  246.          If you like our door, and continue using it beyond a reasonable
  247.          evaluation period, you are obligated to register it with us.  Your
  248.          registration will be good for future releases of the door as well.
  249.          
  250.          Registration of our door simply removes the "* UNREGISTERED *
  251.          Evaluation copy" notice that you and your users see when the door
  252.          loads, and replaces it with your registration number and name.  Mail
  253.          Manager +Plus+ is not otherwise crippled in *ANY* way.
  254.          
  255.          A companion product, MNET QWK-compatible network processing software,
  256.          is also available from Makai Software.  This product is explained
  257.          elsewhere in this document.
  258.          
  259.          The registration fee structure for Mail Manager +Plus+ / MNET is:
  260.          
  261.             Mail Manager +Plus+ alone                            = $25.00
  262.             Mail Manager +Plus+ and MNET at same time            =  30.00
  263.             MNET - add to existing Mail Manager +Plus+ reg.      =   7.50
  264.                   (incl latest Mail Manager +Plus+ on disk)
  265.             MNET by itself                                       =  10.00
  266.  
  267.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 3 -
  268.      
  269.  
  270.          
  271.          If you are already a registered user of Mail Manager +Plus+, and don't
  272.          want MNET, you're all set; just download the latest version of the
  273.          door from your favorite source.
  274.          
  275.          As you can see, we're not attempting to get rich here, just trying to
  276.          cover some of the cost of development and support.  As a SysOp
  277.          yourself, you already know what it costs for any LD connect time at
  278.          all, and the number of hours spent in front of the keyboard.
  279.          
  280.          If you never intend to register Mail Manager +Plus+ with us, and/or
  281.          need only a fraction of its features, you may wish to consider our
  282.          "free" version of the door instead, which does not require a
  283.          registration fee for continued use.
  284.          
  285.          If you do choose to register, BLESS YOU!  The registration form is on
  286.          the next page.
  287.  
  288.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 4 -
  289.      
  290.  
  291.          REGISTRATION FORM FOR MAIL MANAGER +PLUS+
  292.          
  293.                    Name:  __________________________________________________
  294.          
  295.                 Address:  __________________________________________________
  296.          
  297.          City/State/Zip:  __________________________________________________
  298.          
  299.          Mail Manager +Plus+ version that I am currently using:  ___v3.51___
  300.          
  301.          BBS Name (as you'd like it to appear in the registration information).
  302.          This can be your organization name, your name, or any other one-liner
  303.          that you would like your users to see when the door loads.  Should not
  304.          exceed 60 characters (for display considerations):
  305.          
  306.          ______________________________________________________________________
  307.          
  308.          Specify disk size:  [ ] 3.5"   [ ] 5.25" 360k   [ ] 5.25" 1.2m
  309.          
  310.          Comments (optional): _________________________________________________
  311.          
  312.          ______________________________________________________________________
  313.          
  314.          ______________________________________________________________________
  315.          
  316.          OPTIONAL: BBS phone number and/or Zone:Net/Node ID (for our own use,
  317.                    in case we feel it necessary to contact you directly).
  318.          
  319.                    _____________________________   14.4 [ ]  9600 [ ]  2400 [ ]
  320.          
  321.          [ ] Mail Manager +Plus+ QWK mail door for RBBS-PC and Fido *.MSG,
  322.              with MNET.EXE node QWK network conversion utility ......... $30.00
  323.          
  324.          [ ] Mail Manager +Plus+ QWK mail door for RBBS-PC and Fido *.MSG:
  325.                                                                ......... $25.00
  326.          
  327.          [ ] MNET QWK network node conversion utility alone............: $10.00
  328.          
  329.          [ ] MNET - add to existing Mail Manager +Plus+ registration, with
  330.              current Mail Manager +Plus+ release on disk...............:  $7.50
  331.                  My MMGR+ registration # is _________    <-- IMPORTANT!
  332.          
  333.                                                        Total enclosed: ________
  334.          
  335.          We will mail you a copy of the current version(s) of Mail Manager
  336.          +Plus+ (and/or MNET, if applicable), and instructions for registering
  337.          them in the name entered above.  One registration covers all nodes of
  338.          your BBS.
  339.          
  340.          Send check or money order (payable to F. D. Wilson) for total amount
  341.          in U.S. Funds to:
  342.                                    Makai Software
  343.                                    870 Golden Drive
  344.                                    Newark, OH 43055
  345.  
  346.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 5 -
  347.      
  348.  
  349.          FEATURES/LIMITATIONS
  350.          --------------------
  351.          
  352.          The length of this list got ridiculous a long time ago.  So, we'll
  353.          only list the MAJOR stuff that you might be interested in:
  354.          
  355.             ■ Can use a FOSSIL for communications.
  356.             
  357.             ■ Supports both DESQview and NetBIOS file & record locking schemes,
  358.               as well as file sharing under NetBIOS, and supports Novell
  359.               networks.
  360.             
  361.             ■ Support for running as a DOS application under OS/2.
  362.             
  363.             ■ Mail packets can be downloaded in either text or QWK format.
  364.               Both types of mail packets can, at the option of the sysop,
  365.               contain all sorts of additional stuff such as bulletins, news,
  366.               new file listings, etc.
  367.             
  368.             ■ Supports the optional multiple message headers that were
  369.               introduced in RBBS-PC v17.4.
  370.             
  371.             ■ Supports both types of RBBS-PC message bases, fixed-length and
  372.               'elastic'.  (Your message bases are 'elastic' if you have
  373.               configured them to GROW as messages are added).  Can handle a mix
  374.               of both 'fixed-length' and 'elastic' message bases.
  375.             
  376.             ■ Supports FIDO-style *.MSG message bases, as well as RBBS-PC's own
  377.               *M.DEF's.
  378.             
  379.             ■ Supports FIDO-style *.MSG netmail areas.  If using a Binkley-
  380.               compatible mailer, also provides CRASH capability, file-attaches,
  381.               and file requests.  Supports "point" addresses.
  382.             
  383.             ■ Each FIDO-style *.MSG area is configured with its own
  384.               Zone:Net/Node address, so you can painlessly be a part of many
  385.               different mail zones.  Also, AKA addresses are supported for
  386.               Netmail areas, so crash mail can be sent to many different zones
  387.               with a single netmail area.
  388.             
  389.             ■ Supports QWK networks, can generate net-status-capable QWK
  390.               packets for specific usernames.
  391.             
  392.             ■ Users can read, reply, and post messages to both RBBS-PC *M.DEF
  393.               and Fido *.MSG areas while online within the door, as well as use
  394.               offline QWK/REP transfer of mail.
  395.             
  396.             ■ Multi-node support (up to 36 nodes) via DORINFOx.DEF and separate
  397.               subdirectories for each node (built by Mail Manager on-the-fly).
  398.             
  399.             ■ Up to 500 conferences can be configured.
  400.             
  401.             ■ Support for non-standard communication ports & IRQ's via FOSSIL,
  402.               MAILMGR.PRO, and batch files.
  403.             
  404.  
  405.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 6 -
  406.      
  407.  
  408.             ■ Sysop-configurable limit of number of messages which can be
  409.               extracted & downloaded in any one mail packet (default is 1000).
  410.               Subsequent downloads will extract any additional waiting
  411.               messages.  (1,000 messages means at least a 300K compressed mail
  412.               packet).  User can set own lower limits if desired.
  413.             
  414.             ■ BPS rates up to 115K, and COM ports 1-4 are supported.
  415.             
  416.             ■ X, Y, and Zmodem for file transfers via Forsberg's DSZ, or you
  417.               can use our implementation of PROTO.DEF (MAILMGR.PRO) and
  418.               configure a number of different protocols.
  419.             
  420.             ■ "(R)", and "Re:", when found at the beginning of the subject
  421.               field of extracted messages, are stripped from the field.  This
  422.               allows offline readers to group related messages together, rather
  423.               than into one group with and one without.
  424.             
  425.             ■ High/low ASCII can be allowed or stripped in each conference.
  426.             
  427.             ■ ANSI can be allowed or stripped in each conference.
  428.             
  429.             ■ Mail reader tearlines in uploaded messages can be altered (for
  430.               possible FIDO compatibility) from "--- " to "... ", or left alone
  431.               for each conference.
  432.             
  433.             ■ The popular "alias" merge is supported, and alias names can be
  434.               allowed or disallowed by conference.
  435.             
  436.             ■ Conferences can be joined from within the door, or can be
  437.               configured to force the users to join from RBBS-PC.
  438.          
  439.             ■ Extensive security checks.
  440.  
  441.      MAIL MANAGER +PLUS+ GENERAL INFORMATION                         - Page 7 -
  442.      
  443.  
  444.          CHECKLIST OF REQUIREMENTS
  445.          -------------------------
  446.          
  447.          [ ] DOS v3.30 or above.
  448.          
  449.          [ ] At least one RBBS-PC message base and user file, or if you are
  450.              running a BBS type other than RBBS-PC, a conversion utility to
  451.              create one for you.
  452.          
  453.          [ ] If you are running RBBS-PC, separate RBBS-PC users files for each
  454.              conference/subboard.
  455.          
  456.          [ ] DORINFOx.DEF for remote operation.
  457.          
  458.          [ ] A recent version of DSZ.COM (one that supports the "handshake
  459.              slow" command) *IN A DOS PATH!*, or the external protocols of your
  460.              choice via MAILMGR.PRO (our implementation of RBBS-PC's
  461.              PROTO.DEF).
  462.          
  463.          [ ] The environment variable of your choice set to indicate where Mail
  464.              Manager is to look for "XFER-[node].DEF" (where [node] is the node
  465.              number).  XFER-x.DEF is no longer required to be in the default
  466.              directory.
  467.          
  468.          [ ] The file compression/extraction programs of your choice in a DOS
  469.              path, or wherever you specified them in Mail Manager's list of
  470.              archivers (MAILMGR.ARL).
  471.          
  472.          [ ] Memory:
  473.              - About 310K free memory for Mail Manager +Plus+ itself, plus
  474.              - 384 bytes for each conference, plus
  475.              - whatever you need for your file compression software and
  476.                external protocols.
  477.              
  478.              Think about this.  200 conferences * 384 bytes each = 76,800
  479.              additional bytes.  That's about 386K BEFORE your external
  480.              compression and file transfer software.  The full slew of
  481.              conferences (500 * 384) would be an additional 192K (or a total of
  482.              about 502K).  Figure in another RAM-hungry application like Robert
  483.              Jung's ARJ archiver, and you could need more conventional memory
  484.              than your PC has available!
  485.              
  486.              There is a wonderful shareware program available out there,
  487.              written by Davis Augustine, by the name of "SHROOM".  SHROOM has
  488.              the ability to swap an application to disk (or a RAM disk, for
  489.              speed) whenever the application "shells" to an external program.
  490.              SHROOM works very well with Mail Manager +Plus+ (RBBS-PC, too!),
  491.              and you would be well-advised to look into this utility if you are
  492.              tight on RAM, and/or have a large number of conferences to
  493.              configure into Mail Manager +Plus+.
  494.              
  495.              You can locate SHROOM on many Bulletin Boards, or by contacting
  496.              the author directly:
  497.                              Davis Augustine (Shroom Shareware)
  498.                              P.O. Box 610, Sausalito, CA 94966-0610
  499.  
  500.      INSTALLING MAIL MANAGER +PLUS+                                  - Page 8 -
  501.  
  502.  
  503.          BEFORE YOU BEGIN
  504.          ----------------
  505.          
  506.          *********************** PLEASE READ THIS!!!!!! ***********************
  507.          
  508.          RBBS-PC has the unique ability to create, read, and manipulate its own
  509.          corrupted message bases, without ever telling you that anything's
  510.          wrong.
  511.          
  512.          Mail Manager is not as forgiving, and requires that your message bases
  513.          be in good condition.  It is therefore STRONGLY suggested that you run
  514.          some type of checkout/repair utility against your message bases BEFORE
  515.          installing Mail Manager.  We've included a utility named MailFix to
  516.          repair/purge/renumber your message bases, which you can try out as an
  517.          alternative to CONFIG.EXE's repair and purge functions.
  518.          
  519.          MailFix is compatible with RBBSMail'ed, MsgToss'ed, and OverMail'ed
  520.          message bases (which have differently-formatted message headers), as
  521.          well as RBBS-standard message bases, INCLUDING v17.4 multi-headers.
  522.          This is in contrast to RBBS-PC's CONFIG option #185, which simply will
  523.          not properly handle a message base that has been manipulated by any of
  524.          these mail processors.
  525.          
  526.          *PLEASE* take a few minutes to read the section of this document
  527.          regarding MailFix before you attempt to utilize this program!
  528.          
  529.          In any event, you really SHOULD check out the integrity of your
  530.          message bases before attempting to install Mail Manager.
  531.  
  532.      INSTALLING MAIL MANAGER +PLUS+                                  - Page 9 -
  533.  
  534.  
  535.          ----------------------------------------------------------------------
  536.                           UPGRADING FROM A PREVIOUS VERSION
  537.          ----------------------------------------------------------------------
  538.  
  539.          Version 3.50 is a major update to the Mail Manager +Plus+ version 3.xx
  540.          series.  Version 3.51 is a minor update to v3.50.  If you are
  541.          upgrading from v3.50, you need only drop in the v3.51 MAILMGR.EXE
  542.          and go.  No other changes are needed.
  543.  
  544.          If you are upgrading from a version lower than 1.30, your best bet is
  545.          to set up Mail Manager +Plus+ from scratch.  The changes are simply
  546.          too extensive.  Initial installation is covered in a page or two.
  547.          
  548.          With that out of the way, there are several things common to ALL
  549.          upgrades from v1.30 through 3.11:
  550.          
  551.              [ ] - Back up your Mail Manager directory!  It never hurts to play
  552.                    it safe.
  553.  
  554.              [ ] - Overwrite all executables with the ones contained within
  555.                    351-EXE.ZIP.  (You backed up your old ones, right?)
  556.  
  557.              [ ] - Install the *.HLP files, which are revised with this
  558.                    release.
  559.  
  560.          If you are upgrading from a version earlier than v3.10:
  561.  
  562.              [ ] - The main menu options have changed a bit.  If you have
  563.                    created custom menus, change them to reflect the new option
  564.                    lineup - de-compress the file MAILMGR.MNU from 351-TXT.ZIP,
  565.                    and have a look at what's there.  If you are using the
  566.                    default menus, just overwrite your existing ones with
  567.                    MAILMGR*.MNU in 351-TXT.ZIP.
  568.  
  569.              [ ] - Since the main menu items have changed, the Mail Manager
  570.                    help files have too.  Delete your old MAILMGR*.HLP files,
  571.                    and use the new ones contained within 351-TXT.ZIP.  If you
  572.                    are upgrading from a version earlier than 3.0, you'll notice
  573.                    these help files have a new naming convention: MMGR*.HLP.
  574.                    Do not rename them.
  575.              
  576.          SUPPLEMENTAL EXECUTABLES:
  577.          
  578.          MAILFIX.EXE, our message base maintenance utility has been greatly
  579.          enhanced from the version included with Mail Manager releases prior to
  580.          v3.10, and with this release a new /P command line option has been
  581.          added.  The MNET.EXE QWK network utility has also been updated from
  582.          the initial version included with Mail Manager v 3.0x.  Also,
  583.          MINDEX.EXE (our Fido *.MSG index utility) has been updated with this
  584.          release as well (new /L command line option).  You may wish to read
  585.          the documentation on these new versions.
  586.  
  587.          That's it for the initial stuff.  Now, find the version you are
  588.          upgrading from below, and follow the instructions for that upgrade,
  589.          and all later ones:
  590.          
  591.  
  592.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 10 -
  593.  
  594.  
  595.          UPGRADING FROM THE "FREE" MAIL MANAGER v1.3x
  596.          ---------------------------------------------
  597.  
  598.             Although it is relatively painless to upgrade from v1.3x of Mail
  599.             Manager, please be aware that both the configuration file and user
  600.             file (MAILMGR.CFG and MAILMGR.USR) have changed in format, and the
  601.             new MAILCFG program will report that your old configuration file is
  602.             corrupt.
  603.             
  604.             Run the supplied UPDATE.EXE against your existing configuration
  605.             file, then run the supplied UPDATUSR.EXE against your existing
  606.             MAILMGR.USR file.  MAKE SURE YOU RUN THESE UTILITIES FROM YOUR MAIL
  607.             MANAGER DIRECTORY!  After you've run these utilities once, you can
  608.             throw them away (UPDATE.EXE and UPDATUSR.EXE).
  609.             
  610.                       **********************************************
  611.                 --->> *  RUN UPDATUSR.EXE ONCE AND ONLY ONCE!!!!!  * <<---
  612.                       **********************************************
  613.             
  614.             After that, run the new MAILCFG.EXE and carefully look for changes,
  615.             especially in the conference edit screen.  You'll have to go into
  616.             the new manual if some of the options appear confusing.
  617.          
  618.          
  619.          UPGRADING FROM "PLUS" v2.0x:
  620.          ----------------------------
  621.          
  622.             Run the new MAILCFG against your existing configuration file(s),
  623.             and save your changes when finished.  There is a new option on the
  624.             second screen of the main configuration:
  625.          
  626.                - Allow G)oodbye and E)xpedite! options to drop DTR?
  627.                  (Default = No)
  628.                
  629.             There are also new options in each conference:
  630.              
  631.                - Number of lines allowed per message (Default = 99).  Set this
  632.                  to zero (0) to not split long uploaded messages into smaller
  633.                  parts.
  634.                
  635.                - Conference description, up to 25 characters (no default).
  636.              
  637.          
  638.          UPGRADING FROM "PLUS" v3.00 and v3.01:
  639.          --------------------------------------
  640.          
  641.             There is one new option on the second screen of MAILCFG - you can
  642.             now tell Mail Manager to display or hide empty conferences when
  643.             your users are in the conference selection screens.
  644.             
  645.             Nothing else has changed from a configuration standpoint since
  646.             previous v3.x releases except the distributed PRELOG*.RBS and
  647.             EPILOG*.RBS text files, which you probably aren't using anyway.
  648.             
  649.          
  650.  
  651.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 11 -
  652.  
  653.  
  654.          UPGRADING FROM "PLUS" v3.10:
  655.          ----------------------------
  656.          
  657.             If you are running Mail Manager from a "point" setup, you can now
  658.             enter your point address for each conference in MAILCFG, either as
  659.             a full 4D address or as a "fakenet" address.
  660.             
  661.          UPGRADING FROM "PLUS" v3.11:
  662.          ----------------------------
  663.          
  664.             There are three new sysop options in MAILCFG:
  665.             
  666.             - sysop can configure the maximum number of messages to allow in
  667.               one packet in the event he wishes to change this from the default
  668.               1000.
  669.                
  670.             - sysop can choose whether to enable the built-in online R)ead and
  671.               P)ost capabilities.
  672.             
  673.             - sysop can configure the conference which receives violation
  674.               notices to be mandatory.  Normally this would be conf #1, but
  675.               this can be changed by loading MAILMGR via the new /Vnn switch,
  676.               where nn is the conference to receive violation notices.
  677.             
  678.             These options are found on a new third MAILCFG screen.
  679.             
  680.          IF YOU'RE SETTING UP FOR THE FIRST TIME:
  681.          ----------------------------------------
  682.          
  683.          There is no such thing as a "QUICK INSTALL" for Mail Manager +Plus+,
  684.          although you can be up and running fairly easily by:
  685.          
  686.              - Creating a \MAILMGR directory off of your root,
  687.              - De-compressing the archives 351-EXE.ZIP and 351-TXT.ZIP there,
  688.              - Run MAILCFG.EXE, and follow the prompts, then...
  689.              - Follow standard procedure for adding a new door to your system
  690.                (DOORS.DEF, menus, etc. etc.)
  691.          
  692.          However, we do *NOT* recommend that you do it this way if you have
  693.          more than a handful of conferences, and plan to add or delete any in
  694.          the foreseeable future.  A little advance planning *NOW* can save you
  695.          a world of grief later, and there are many customizable text files
  696.          that you may want to change.
  697.          
  698.  
  699.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 12 -
  700.  
  701.  
  702.          ----------------------------------------------------------------------
  703.                            INSTALLING THE DOOR FROM SCRATCH
  704.          ----------------------------------------------------------------------
  705.          
  706.          If for some reason these instructions are not clear to you, or this is
  707.          your first attempt at installing a door in your RBBS-PC, there's
  708.          really not much that can take the place of RBBS-PC's documentation.
  709.          
  710.          With that said...
  711.          
  712.          Check your environment variables (type "SET" at the DOS prompt).  Both
  713.          RBBS-PC and Mail Manager +Plus+ use the log file "XFER-x.DEF", where
  714.          "x" is the node number.  Mail Manager +Plus+ needs an environment
  715.          variable to determine where this file is located on your system.  Most
  716.          of us seem to be using Forsberg's DSZ for file transfers, so there
  717.          should be a line referencing "DSZLOG" in either the batch file you use
  718.          to load RBBS-PC, or your system's AUTOEXEC.BAT, which would look
  719.          something like this for node 1:
  720.          
  721.             DSZLOG=C:\RBBS\XFER-1.DEF
  722.          
  723.                or...
  724.          
  725.             DSZLOG=XFER-1.DEF
  726.          
  727.          If Mail Manager +Plus+ cannot find "XFER-x.DEF", it will report that
  728.          all file transfers have failed.
  729.          
  730.          In any case, make a note of the environment variable name (in this
  731.          case DSZLOG), since you'll need it later.
  732.          
  733.          Once you're past this, you can get on to the actual installation.
  734.          
  735.          Create a subdirectory just for Mail Manager +Plus+.  Stick it anywhere
  736.          you want, and name it anything you want, just be sure that it is a
  737.          drive and directory specifically meant for Mail Manager +Plus+.  From
  738.          here on we'll just refer to it as the "\MAILMGR" directory.
  739.          
  740.          De-compress the imbedded archives "351-EXE.ZIP" and "351-TXT.ZIP" to
  741.          the directory you just created.
  742.          
  743.          Now go through the motions of adding a new door to your system.  On a
  744.          'normal' RBBS-PC this would entail:
  745.          
  746.             - Editing MENU5* (or whatever you have named your door menu) and
  747.               adding the word " MAILMGR ".
  748.             
  749.             - Creating a MAILMGR.BAT file, and sticking it where RBBS can find
  750.               it.  Your batch file that calls Mail Manager is very important,
  751.               and as a minimum must logically do the following:
  752.             
  753.  
  754.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 13 -
  755.  
  756.  
  757.               - change to drive and directory where MAILMGR.EXE is located
  758.               - copy the DORINFOx.DEF door information file to the Mail Manager
  759.                 directory
  760.               - execute the MAILMGR program
  761.               - return to your RBBS directory
  762.          
  763.          With that in mind, a minimum batch file would look something like
  764.          this:
  765.          
  766.                    cd\mailmgr
  767.                    copy \rbbs\dorinfo%1.def
  768.                    mailmgr %1
  769.                    cd\rbbs
  770.          
  771.          If you're running the recent "DOORS.DEF" method that RBBS-PC provides,
  772.          here's an example line to implement Mail Manager:
  773.          
  774.                           MAILMGR,5,,D,"MAILMGR.BAT [NODE]",N,,
  775.          
  776.             This line tells RBBS-PC the following:
  777.          
  778.                1) The name of the door is MAILMGR.
  779.                2) Security level 5 and above can access the door.
  780.                3) No questionnaire is to be invoked.
  781.                4) Exit to this door, rather than shell to it. (Mail Manager
  782.                   requires a lot of RAM)
  783.                5) The name of the batch file to invoke is MAILMGR.BAT.
  784.                6) RBBS-PC is to pass the node number to the batch file.
  785.          
  786.                  * NOTE - Type the word "[NODE]" as shown above, and RBBS-PC
  787.                    will replace it with the true node number when it calls the
  788.                    batch file.  If you are running a single-node system, and
  789.                    find this confusing, you can instead pass the node number
  790.                    directly, but it isn't necessary to do it this way.  This
  791.                    would make your DOORS.DEF line look something like this:
  792.          
  793.                           MAILMGR,5,,D,"MAILMGR.BAT 1",N,,
  794.          
  795.                7) Don't ask for a password when returning back to RBBS-PC.
  796.                8) Don't display a text file when the door closes.
  797.                9) Use the time limit from RBBS-PC as the time allowed in the
  798.                   door.
  799.  
  800.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 14 -
  801.  
  802.  
  803.          IF YOU HAVE A LOCKED BPS RATE
  804.          -----------------------------
  805.          
  806.          If you have your communications port locked higher than what the
  807.          user's actual connect speed is going to be, you may find that Mail
  808.          Manager +Plus+ will not report the correct BPS rate, nor will it
  809.          estimate the amount of time required for file transfers properly.
  810.          This is due to RBBS-PC passing the locked BPS rate to the door,
  811.          instead of true connect speed.
  812.          
  813.          RBBS-PC versions 17.3C and lower had no provision for passing the true
  814.          connect rate to doors.  The locked rate is always passed to
  815.          DORINFOx.DEF.  The only way around this is to run RBBS-PC v17.4 or
  816.          later, and modify the command line used to call Mail Manager +Plus+.
  817.          The following will work *ONLY* with RBBS-PC v17.4 and up! (or with
  818.          copies of RBBS-PC compiled with the CBAUD merge):
  819.          
  820.          Change the DOORS.DEF example mentioned on earlier to read:
  821.          
  822.                  MAILMGR,5,,D,"MAILMGR.BAT [NODE] [CBAUD]",N,,
  823.          
  824.          Then, in your batch file that loads the door:
  825.          
  826.                  mailmgr %1 /CBAUD%2
  827.          
  828.          If the door is called on node 4 of your system, and the user's connect
  829.          rate is 2400 BPS, the above line will look like this to Mail Manager
  830.          +Plus+:
  831.          
  832.                  mailmgr 4 /CBAUD2400
  833.          
  834.          With this done, your basic door installation is finished, and the time
  835.          has come to plan your interface for the users, and to configure the
  836.          door for your system.
  837.  
  838.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 15 -
  839.  
  840.  
  841.          COMMAND LINE OPTIONS
  842.          --------------------
  843.          
  844.          Mail Manager +Plus+ has several different available command line
  845.          options.  You will never use all of them at once, but variations of
  846.          these can be useful for the various operations that the door is
  847.          capable of performing.
  848.          
  849.            MAILMGR [Node] [/I] [/O] [/A] [/CBAUDxxxxx] [/WX:\PATH] [/Vxx]
  850.          
  851.               Node = The node number currently in use. (1, 2, 3, etc.)
  852.               
  853.                 /I = "Import mode".  Most useful when operating in local mode,
  854.                       this option causes the door to immediately process a REP
  855.                       packet that is waiting in the proper work directory.
  856.               
  857.                 /O = "Output mode".  Most useful when operating in local mode,
  858.                       this option causes the door to immediately extract mail
  859.                       from your selected conferences, creating a new mail
  860.                       packet.
  861.               
  862.                 /A = "Automatic mode".  Again, most useful in local mode.  This
  863.                       option causes the door to go straight into E)xpedite
  864.                       mode, which will process any waiting .REP, and also
  865.                       extract any new waiting mail.
  866.               
  867.               /CBAUD = An option that became available with the advent of RBBS-
  868.                       PC's template variable "[CBAUD]", which is the true
  869.                       connect rate of the user.  This option can be used in
  870.                       your DOORS.DEF as follows, but ONLY IF YOU ARE RUNNING A
  871.                       VERSION OF RBBS-PC THAT SUPPORTS THE [CBAUD] VARIABLE!:
  872.                       
  873.                                            /CBAUD[CBAUD]
  874.                       
  875.                       Then, if the user were connected at 2400 bps on your
  876.                       system, Mail Manager +Plus+ would see it like so:
  877.                       
  878.                                             /CBAUD2400
  879.                       
  880.                       This makes the door capable of accurately determining
  881.                       transfer times for your users.
  882.               
  883.                 /W =  Drive/path to use for work directories.  Mail Manager
  884.                       +Plus+ normally creates and manipulates files in separate
  885.                       directories off of the directory in which you installed
  886.                       the door.  If you are tight on disk space on this drive,
  887.                       or would rather use a ram disk for a work drive, you can
  888.                       specify this option.  NOTE - If you implement this
  889.                       option, and intend to use a RAM disk for a work drive, it
  890.                       had best be a BIG one indeed!  Don't forget that a single
  891.                       MESSAGES.DAT can be over 1 meg in size, plus the archived
  892.                       mail packet itself.  And if you have multiple nodes all
  893.                       trying to use this ram disk, you'll need a big one.  If
  894.                       you run out of room, you will not be able to pack/unpack
  895.                       the QWK or REP packet.
  896.  
  897.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 16 -
  898.  
  899.  
  900.                       
  901.                       To use drive "X" as your work drive, this command would
  902.                       look like this:
  903.                                            /WX:
  904.                       
  905.                       The door *will* create separate work subdirectories (such
  906.                       as \LOCAL, \NODE1, etc.) off of what you specify here.
  907.                       In the above example, X:\LOCAL, X:\NODE1, etc. would be
  908.                       used as your work directories.  You can specify a
  909.                       specific path to use as the base for these directories,
  910.                       if you do not want them off the root of your work drive.
  911.                       
  912.                       If you do not use this option, Mail Manager +Plus+ will
  913.                       create the work directories off the directory in which
  914.                       you installed the door.
  915.               
  916.                /Vnn = Conference which should receive any security violation
  917.                       messages generated by Mail Manager +Plus+.  By default
  918.                       violation messages are placed in conference #1, but you
  919.                       can change this to any conference you wish.  To change to
  920.                       conference 2, you would use the switch as /V2.
  921.          
  922.          Sample command lines, based on the above:
  923.          
  924.            MAILMGR  - No command line always assumes local operation.  Door
  925.                       will come up in local mode, using the sysop name as
  926.                       listed in the configuration file.  Any mail packets
  927.                       created during the session will be placed in the \LOCAL
  928.                       work directory, as mentioned above.
  929.            
  930.            MAILMGR /A  - Local mode, automatic operation.  Goes straight into
  931.                       expedite mode, then returns to DOS.  Processes any
  932.                       waiting .REP in the \LOCAL work directory, and will also
  933.                       create a mail packet there if there was any new unread
  934.                       mail waiting to be picked up.
  935.            
  936.            MAILMGR 1 /o  - Read DORINFO1.DEF for operating parameters, create a
  937.                       new mail packet in the \NODE1 work directory, and return
  938.                       to DOS.
  939.            
  940.            MAILMGR 1 /i  - Read DORINFO1.DEF for operating parameters, process
  941.                       any waiting .REP packet in the \NODE1 work directory, and
  942.                       return to DOS.
  943.            
  944.            MAILMGR 5 /CBAUD14400 /wD:\WORK  - Read DORINFO5.DEF for operating
  945.                       parameters, tell the door that the connect rate is 14400
  946.                       bps, and use D:\WORK as the base drive/dir for the door's
  947.                       work directories.  The program will use D:\WORK\NODE5 as
  948.                       its work directory.
  949.            
  950.            MAILMGR 3 /CBAUD2400 /V5  - Read DORINFO3.DEF for operating
  951.                       parameters, tell the door that the connect rate is 2400
  952.                       BPS, and have conference #5 receive any violation
  953.                       notices.
  954.          
  955.  
  956.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 17 -
  957.  
  958.  
  959.          By careful, planned use of these options, and "dummy" DORINFOx.DEF
  960.          files with the communications port configured as COM0, you can do some
  961.          mighty advanced stuff via batch files.  Some thoughts that come
  962.          immediately to mind are "prescanned" mail packets for specific users,
  963.          and automatic operation of QWK networking.  As you become more
  964.          familiar with the door, and begin using it yourself in local mode as
  965.          the sysop, more and more of these options are likely to become useful
  966.          to you.
  967.  
  968.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 18 -
  969.  
  970.  
  971.          PLANNING YOUR USER INTERFACE
  972.          ----------------------------
  973.          
  974.          As with most aspects of your RBBS-PC, you will get the best results
  975.          from Mail Manager +Plus+ with a little advance planning.  To your
  976.          users, the single most important aspect of Mail Manager will be the
  977.          ability to locate which conferences they want to follow.  This sounds
  978.          simple enough, but think about that for a second, especially if you're
  979.          running a system with more than a handful of conferences.
  980.          
  981.          Here are some serious points to consider BEFORE diving into the
  982.          configuration program:
  983.          
  984.              1 - Your RBBS-PC MAIN message base must ALWAYS be configured as
  985.                  conference #1.  This is VERY IMPORTANT - Mail Manager +Plus+
  986.                  simply will not function properly if your MAIN area is not #1
  987.                  on the list.  The door uses the information found in the MAIN
  988.                  area for some of its default functions for each user.  If you
  989.                  are not running RBBS-PC, your conversion utility that loads
  990.                  the door must be capable of creating RBBS-PC users and
  991.                  messages files, which you would configure as area #1.  The
  992.                  user file created in this operation MUST (as a minimum)
  993.                  contain information for the user that is loading the door.
  994.              
  995.              2 - Once MailCFG creates your configuration file, and your users
  996.                  start using the door, you cannot easily re-sort your
  997.                  conferences.
  998.              
  999.              3 - If you have several different TYPES of conferences (such as
  1000.                  local, RBBS-NET, FIDO-NET, etc.), you'll want to consider how
  1001.                  to group the conferences together for the user's purposes.
  1002.              
  1003.              4 - Will you be adding more conferences at some point?  Will you
  1004.                  want those conference names to be inserted in the middle of
  1005.                  your list of conference numbers?  It is easy to tack
  1006.                  conferences onto the end, but to insert them in the middle
  1007.                  requires a little forethought to skip empty conference numbers
  1008.                  *NOW*.
  1009.              
  1010.              5 - After Mail Manager +Plus+ has been running for a while, and
  1011.                  you decide to delete a conference, delete it, but RESERVE THE
  1012.                  SPACE FOR THAT CONFERENCE NUMBER!!!  If you don't, your
  1013.                  conferences will be re-numbered, and the unsuspecting users
  1014.                  might inadvertently upload a reply to the wrong conference
  1015.                  number.
  1016.          
  1017.          If all this is too much to think about for the moment, consider this
  1018.          relatively simple example...  Say you have a total of 3 conferences:
  1019.          
  1020.                1 MAIN message base, 1 RBBS-NET area, and 1 FIDO-NET area.
  1021.          
  1022.          Now, if you think at some point that you might add two more
  1023.          conferences to your list of RBBS-NET conferences, and maybe five more
  1024.          local areas, here's how you might want the conference numbers to look
  1025.          from Mail Manager's standpoint:
  1026.  
  1027.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 19 -
  1028.  
  1029.  
  1030.               1 - MAIN     - My main message base
  1031.               2 -  ---
  1032.               3 -  ---
  1033.               4 -  ---
  1034.               5 -  ---
  1035.               6 -  ---
  1036.               7 - RBBSNET  - An RBBSNet conference
  1037.               8 -  ---
  1038.               9 -  ---
  1039.              10 - FIDONET  - A FidoNet conference
  1040.          
  1041.          Now, when you do add an extra local conference, you can insert it in
  1042.          position #2, 3, 4, 5, or 6.
  1043.          
  1044.          Otherwise, your conferences will be ordered as:
  1045.          
  1046.               1 - MAIN
  1047.               2 - RBBSNET
  1048.               3 - FIDONET
  1049.          
  1050.          ... and you would have to tack that new local conference on at
  1051.          position #4.  Starting to make sense now?
  1052.          
  1053.          OK... with that in mind, if you have a CONFMAIL.DEF file (RBBS-PC's
  1054.          list of conferences), copy it to your Mail Manager directory, and take
  1055.          a look at it.  If you don't have a CONFMAIL.DEF, go ahead and skip
  1056.          this section.
  1057.          
  1058.          Are your conference types grouped together?  Do you want to leave
  1059.          spaces between any of them?  Is the FULL PATH TO THE CONFERENCE
  1060.          listed, or does it just read something like:
  1061.          
  1062.                 C:MAINU.DEF, C:MAINM.DEF   ?
  1063.          
  1064.          The above WON'T WORK.  Mail Manager +Plus+ does not operate out of
  1065.          your RBBS directory, and therefore won't know where to find your
  1066.          conferences.  You will need to change each line to reflect the FULL
  1067.          PATH to the conference, something like:
  1068.          
  1069.                 C:\RBBS\MAINU.DEF, C:\RBBS\MAINM.DEF
  1070.          
  1071.          That's why we suggested you make a copy of your CONFMAIL.DEF, and then
  1072.          use the EDITED COPY for importing into MAILCFG.  With that done, now's
  1073.          the time to sort it however you see fit, making sure that your MAIN
  1074.          area is the very first one listed, at the top of the file.
  1075.          
  1076.          If you want to add empty conference numbers between any of them, add
  1077.          the following line:
  1078.          
  1079.                      {EMPTY}U.DEF,
  1080.          
  1081.          MailCFG will reserve that spot for future use.  Using a real quick
  1082.          example, say you have two conferences, and your current CONFMAIL.DEF
  1083.          looks like this:
  1084.          
  1085.  
  1086.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 20 -
  1087.  
  1088.  
  1089.                       C:\RBBS\MAINU.DEF,C:\RBBS\MAINM.DEF
  1090.                       C:\RBBS\BBSADSU.DEF,C:\RBBS\BBSADSM.DEF
  1091.          
  1092.          If you wanted to reserve a space between these two, you would edit the
  1093.          copy of CONFMAIL.DEF that you copied to Mail Manager's directory
  1094.          (don't edit your RBBS original) to look like this:
  1095.                       C:\RBBS\MAINU.DEF,C:\RBBS\MAINM.DEF
  1096.                       {EMPTY}U.DEF,
  1097.                       C:\RBBS\BBSADSU.DEF,C:\RBBS\BBSADSM.DEF
  1098.          
  1099.          Mail Manager will see conference #2 as empty, and you'll be able to go
  1100.          back into MailCFG to add it in later.  DON'T FORGET THE COMMA AFTER
  1101.          {EMPTY}U.DEF !!
  1102.          
  1103.          One last thing to note here is that you can configure Mail Manager to
  1104.          display the empty conference spaces to your users, or to condense the
  1105.          listing to just those conferences available to them (we'll cover that
  1106.          in the section on the MAILCFG configuration utility).  If you choose
  1107.          to display the empty conferences, Mail Manager displays conferences to
  1108.          the users in either columns of 10, like so:
  1109.          
  1110.                1               11              21
  1111.                2               12              22
  1112.                3               13              etc..
  1113.                4               14
  1114.                5               15
  1115.                6               16
  1116.                7               17
  1117.                8               18
  1118.                9               19
  1119.               10               20
  1120.          
  1121.          ...or in groups of 15 if they are viewing conference descriptions:
  1122.          
  1123.                1 MAIN    - My main message base
  1124.                2 CONF2   - My second conference
  1125.                3         - (etc. etc. etc.)
  1126.                4         -
  1127.                5         -
  1128.                6         -
  1129.                7         -
  1130.                8         -
  1131.                9         -
  1132.               10         -
  1133.               11         -
  1134.               12         -
  1135.               13         -
  1136.               14         -
  1137.               15         -
  1138.          
  1139.          If you have a large number of conferences, you may want to take this
  1140.          into consideration as well.
  1141.          
  1142.  
  1143.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 21 -
  1144.  
  1145.  
  1146.          Once you have prepared CONFMAIL.DEF for Mail Manager +Plus+ as
  1147.          mentioned above, it is ready for importing into the MAILCFG.EXE
  1148.          configuration program.
  1149.          
  1150.          One last thing to mention here is that CONFMAIL.DEF is not used by
  1151.          Mail Manager +Plus+ itself at all.  Once you have imported your
  1152.          conferences into the MAILCFG.EXE program, Mail Manager +Plus+ will
  1153.          never look at your CONFMAIL.DEF again.
  1154.          
  1155.          Now that your temporary copy of CONFMAIL.DEF is ready for the MAILCFG
  1156.          program, it is time to set up your text files that Mail Manager +Plus+
  1157.          is to use.
  1158.          
  1159.          
  1160.          SYSOP-CONFIGURABLE TEXT FILES
  1161.          -----------------------------
  1162.          
  1163.          The last step before getting into the configuration program is to set
  1164.          up your text files, and Mail Manager +Plus+ uses quite a few.  Here
  1165.          goes:
  1166.          
  1167.              (All in Mail Manager's directory)
  1168.          
  1169.              MMGR1.HLP  \ _   The online help files that will be displayed to
  1170.              MMGR2.HLP  /     users when "H" and "?" are selected from the main
  1171.                               menu.  You can customize if need be, but they
  1172.                               should be pretty much OK as-is.
  1173.          
  1174.              MAILMGR.PRE    - The initial screen displayed when Mail Manager
  1175.                               loads.  Again, you might want to customize it for
  1176.                               your own individual system, but it is generic
  1177.                               enough as distributed that you may not need to.
  1178.                               If this file (and the corresponding graphic and
  1179.                               ANSI versions) do not exist, Mail Manager +Plus+
  1180.                               will take the user Directly to the main menu
  1181.                               after it loads.  Otherwise, this screen will be
  1182.                               displayed, and the prompt "Press any key to
  1183.                               continue..." will be shown.
  1184.              
  1185.              NEW_USER.OPT   - This file is optional.  You can use it to define
  1186.                               the default options Mail Manager will use for new
  1187.                               users, if you don't care for our choice of
  1188.                               defaults.  A sample NEW_USER.OPT file is included
  1189.                               in the distribution archive.  Only the first
  1190.                               character of each line in this file is
  1191.                               significant; the balance of each line is used to
  1192.                               describe to you what each option is for.
  1193.              
  1194.              MAILMGR.MNU    - Mail Manager's main menu, displayed to the users
  1195.                               just before the command prompt.
  1196.              
  1197.  
  1198.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 22 -
  1199.  
  1200.  
  1201.              PRELOG.RBS     - The welcome message that your users will see when
  1202.                               they first fire up their mail reader against one
  1203.                               of Mail Manager's QWK's.  Probably the most
  1204.                               common thing that you'd want to put here would be
  1205.                               a copy of your RBBS-PC prelog or welcome screen,
  1206.                               but this is entirely up to you!
  1207.              
  1208.              EPILOG.RBS     - The signoff message that the users will see just
  1209.                               as they exit your QWK packet from their mail
  1210.                               reader.  You might want to put an adaptation of
  1211.                               RBBS-PC's EPILOG.DEF here.
  1212.          
  1213.              MMGR1G.HLP    \
  1214.              MMGR2G.HLP     \
  1215.              MAILMGRG.PRE    \ ASCII graphic versions of the above.
  1216.              MAILMGRG.MNU    / (Optional)
  1217.              PRELOGG.RBS    /
  1218.              EPILOGG.RBS   /
  1219.          
  1220.              MMGR1C.HLP    \
  1221.              MMGR2C.HLP     \
  1222.              MAILMGRC.PRE    \ Color/ANSI versions of the above.
  1223.              MAILMGRC.MNU    / (Optional)
  1224.              PRELOGC.RBS    /
  1225.              EPILOGC.RBS   /
  1226.          
  1227.              MAILMGR.BUL    - The list of *NON-GRAPHIC* versions of any
  1228.                               bulletins (with full path/filenames) that you'll
  1229.                               want to include in your users' QWKs.  Mail
  1230.                               Manager +Plus+ will look for the "g" or "c"
  1231.                               versions of the bulletins according to the
  1232.                               graphic preference of the callers.
  1233.                               
  1234.                               Edit this file to pertain to your system
  1235.                               bulletins (and/or any other text files that
  1236.                               you'll want to include in your users' QWK
  1237.                               packets), and if any of them are newer than the
  1238.                               user's last call to RBBS-PC, the user will get
  1239.                               them included in his/her QWK packet.
  1240.                               
  1241.                               Bulletins preceded with a double-asterisk are
  1242.                               considered mandatory for inclusion in the user's
  1243.                               mail packets, and if new, they will be included
  1244.                               regardless of whether the user has configured
  1245.                               Mail Manager to send new bulletins.
  1246.                               
  1247.                               Example:
  1248.                               
  1249.                                   c:\bulletin\bulet1
  1250.                                   c:\bulletin\bulet2
  1251.                                   **c:\bulletin\bulet3
  1252.                               
  1253.                               bulet1 and bulet2 are optional, bulet3 will
  1254.                               always be included if it has been updated.
  1255.                               
  1256.  
  1257.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 23 -
  1258.  
  1259.  
  1260.                               (NOTE - The path\filename of MAILMGR.BUL is
  1261.                               sysop-configurable in MailCFG.EXE.)
  1262.              
  1263.              MAILMGR.PRO    - A copy of the RBBS-PC PROTO.DEF that you intend
  1264.                               to have Mail Manager +Plus+ use.  Mail Manager
  1265.                               +Plus+ can use all of RBBS-PC's "template"
  1266.                               variables in here, such as [NODE], [PORT#],
  1267.                               [BAUD], [CBAUD], etc.  Refer to the RBBS-PC
  1268.                               documentation for information on these "template"
  1269.                               variables.
  1270.                               
  1271.                               For the purposes of Mail Manager +Plus+, it is
  1272.                               important that you configure "N)one" as the last
  1273.                               protocol in this file!  You will also need to
  1274.                               configure an external X)modem and Y)modem, since
  1275.                               Mail Manager obviously cannot use RBBS-PC's
  1276.                               internal X and Y that are probably listed in your
  1277.                               existing RBBS-PC PROTO.DEF.  See the sample
  1278.                               MAILMGR.PRO for an example of how to configure
  1279.                               these protocols externally using DSZ.
  1280.                               
  1281.                               If you are running multiple nodes with different
  1282.                               communication port setups, you may want to create
  1283.                               copies of this file with the necessary arguments
  1284.                               changed accordingly (MAILMGR1.PRO, MAILMGR2.PRO,
  1285.                               etc.).
  1286.                               
  1287.                               NOTE #1 - If one of the protocols that you
  1288.                               configure here happens to be bi-directional (like
  1289.                               Samuel Smith's HSLINK), you don't need to do
  1290.                               anything special to implement it.  When the user
  1291.                               downloads a QWK packet, any REP packet that was
  1292.                               received during that transfer will be immediately
  1293.                               processed when the transfer is complete.  Easy!
  1294.                               
  1295.                               NOTE #2 - The path/filename of MAILMGR.PRO is
  1296.                               sysop-configurable in MAILCFG.EXE.
  1297.              
  1298.              MAILMGR.ARL    - The list of archivers that are available to your
  1299.                               users through Mail Manager +Plus+.  MAILMGR.ARL
  1300.                               is a "template" file, similar in structure to
  1301.                               MAILMGR.PRO.
  1302.                               
  1303.                               The supplied copy of MAILMGR.ARL allows the use
  1304.                               of ARC, ARJ, LZH, and ZIP compression methods,
  1305.                               which the user can pick and choose from to suit
  1306.                               their own preference.  You can configure fewer or
  1307.                               additional archivers as you see fit.  Format of
  1308.                               each line:
  1309.                               
  1310.                                          Name, EXT, Compress, Extract
  1311.                               
  1312.  
  1313.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 24 -
  1314.  
  1315.  
  1316.                               Name = The name of the archiver, as shown to the
  1317.                                 user.
  1318.                               EXT = The three-letter extension that this
  1319.                                 archiver creates by default for compressed
  1320.                                 files.
  1321.                               Compress = The line to send to DOS to compress
  1322.                                 the mail packets.
  1323.                               Extract = The line to send to DOS to extract the
  1324.                                 uploaded reply packets that the user uploads.
  1325.              
  1326.                               "Template" variables that can be included in the
  1327.                                 Compress and Extract lines (Mail Manager will
  1328.                                 convert these to their true values):
  1329.              
  1330.                                 [FILE]  - Compressed file to create, or extract
  1331.                                   from.
  1332.                                 [INC]   - All files that Mail Manager normally
  1333.                                   includes in the downloadable archive.
  1334.                                 [REPLY] - Reply file that Mail Manager expects
  1335.                                   to be contained within the compressed upload.
  1336.                                 [NODE]  - Current RBBS-PC node number.
  1337.              
  1338.                               See the supplied MAILMGR.ARL for an example
  1339.                               implementation of this file.
  1340.                               
  1341.                               (NOTE - The path/filename of MAILMGR.ARL is
  1342.                               sysop-configurable in MAILCFG.EXE).
  1343.  
  1344.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 25 -
  1345.  
  1346.  
  1347.          TEXT FILES RELATED TO FIDO *.MSG NETMAIL AREAS
  1348.          ----------------------------------------------
  1349.          
  1350.          Mail Manager +Plus+ has two system text files that pertain only to
  1351.          FIDO-style netmail areas.  If you are not running any of these types
  1352.          of areas, these two files need not exist.  Otherwise, Mail Manager
  1353.          +Plus+ will look for both of these in your Mail Manager directory
  1354.          whenever someone uploads a "crash" (Binkley-style) netmail message.
  1355.          
  1356.              MMGRNODE.AKA     List of "AKA" addresses that your system uses.
  1357.                               If you are a member of more than one network, you
  1358.                               may wish to make use of this file for your
  1359.                               netmail areas.  This is a simple text file,
  1360.                               listing all of the Zone:Net/Node numbers that
  1361.                               pertain to your system.  It's format is as
  1362.                               follows (flush left in the file):
  1363.                               
  1364.                                    1:226/1400
  1365.                                    8:965/9
  1366.                                    10:10/1
  1367.                               
  1368.                               This would inform Mail Manager that you are a
  1369.                               member of three different networks, zones 1, 8,
  1370.                               and 10.  Any netmail message addressed to zone 8
  1371.                               would cause Mail Manager +Plus+ to temporarily
  1372.                               change your ID to "8:965/9" for that particular
  1373.                               message, regardless of the zone:net/node ID that
  1374.                               you configured that netmail area in the MAILCFG
  1375.                               program.
  1376.                               
  1377.                               Only one address per mail zone can be listed
  1378.                               here, since Mail Manager +Plus+ will use the
  1379.                               first one it finds.  For instance, if you set
  1380.                               this file to read:
  1381.                               
  1382.                                    1:226/1400
  1383.                                    1:226/1401
  1384.                                    8:965/9
  1385.                                    10:10/1
  1386.                               
  1387.                               ... Mail Manager +Plus+ will always use the "AKA"
  1388.                               of 1:226/1400 for netmail messages addressed in
  1389.                               zone 1, since that is the first zone 1 address
  1390.                               listed.  See the example MMGRNODE.AKA included in
  1391.                               this package for a sample implementation of this
  1392.                               file.  If MMGRNODE.AKA is not found in your Mail
  1393.                               Manager directory, the Zone:Net/Node address
  1394.                               listed in the configuration file for that
  1395.                               conference will be used at all times.
  1396.              
  1397.  
  1398.     INSTALLING MAIL MANAGER +PLUS+                                  - Page 26 -
  1399.  
  1400.  
  1401.              MMGRNODE.OB      The list of outbound directories that your system
  1402.                               uses.  This file informs Mail Manager +Plus+
  1403.                               where to place CRASH messages, and file
  1404.                               attach/request packets.  If this file is not
  1405.                               found (or not configured properly), you will be
  1406.                               unable to send CRASH netmail.
  1407.                               
  1408.                               The format of MMGRNODE.OB is as follows (again,
  1409.                               flush left):
  1410.                               
  1411.                                    Zone, X:\PATH\OUTBOUND.DIR
  1412.                               
  1413.                               So, if you are in three separate mail zones, your
  1414.                               MMGRNODE.OB file might look like this:
  1415.                               
  1416.                                    1, C:\BINKLEY\OUTBOUND
  1417.                                    8, C:\BINKLEY\OUTBOUND.008
  1418.                                    10, C:\BINKLEY\OUTBOUND.010
  1419.                               
  1420.                               A trailing backslash on the directory name is
  1421.                               optional.
  1422.                               
  1423.                               NOTE: Mail Manager only knows how to send "crash"
  1424.                               mail and file attach/requests on systems running
  1425.                               BinkleyTerm or compatible front ends.  Other
  1426.                               front end systems do things differently, and do
  1427.                               not need the MMGRNODE.OB file.  Users of non-
  1428.                               Binkley front ends can still send/receive regular
  1429.                               routed netmail via this door.
  1430.              
  1431.  
  1432.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 27 -
  1433.  
  1434.  
  1435.          Mail Manager +Plus+'s configuration file (MAILMGR.CFG) is binary in
  1436.          nature (for FAST loading), and can be directly manipulated by the
  1437.          supplied program, MAILCFG.EXE.
  1438.          
  1439.          Since many SysOps are VERY accustomed to using text editors against
  1440.          the various configuration files on their systems, we have managed to
  1441.          catch quite a bit of unexpected flak about the way MAILCFG does
  1442.          things.
  1443.          
  1444.          So now we give you two ways to configure your setup:
  1445.          
  1446.              MAILCFG.EXE - Manipulate the configuration file directly, or use
  1447.                            the following pair of executables:
  1448.              
  1449.              CFG2TXT.EXE - Convert MAILMGR.CFG to a text file.
  1450.              TXT2CFG.EXE - Convert a text configuration file to MAILMGR.CFG.
  1451.          
  1452.          MAILCFG.EXE is the recommended way to go, so the following
  1453.          instructions pertain to the use of this program.  The other pair of
  1454.          programs are covered in the section of this document entitled:
  1455.          "UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+".
  1456.          
  1457.          Change to your Mail Manager directory, and run MAILCFG.EXE.
  1458.          
  1459.          The first time you fire up MAILCFG, it isn't going to find the
  1460.          configuration file, MAILMGR.CFG.  MAILCFG will report to you as such,
  1461.          and ask you if this is a first-time setup.  (Just answer "Y" at this
  1462.          point).
  1463.          
  1464.          Just for the record, if you tell it "N", (this is not a first-time
  1465.          setup), MAILCFG will figure that you started it from the wrong
  1466.          directory, and will ask you for the correct path/name to MAILMGR.CFG.
  1467.          
  1468.          After you press "Y", MAILCFG will prompt you whether to A)uto-config,
  1469.          or M)anually configure your conferences.
  1470.             
  1471.             A)uto   - If you're not familiar with RBBS' CONFMAIL.DEF, ignore
  1472.                       this option, and choose M)anual instead.
  1473.                       
  1474.                       This option will let you choose the path\filename of your
  1475.                       CONFMAIL.DEF, and then ask you for default values to
  1476.                       auto-create for EVERY conference.  This can save LOTS of
  1477.                       time if you have many conferences to configure into Mail
  1478.                       Manager.
  1479.                       
  1480.                       SUGGESTION:  At this point, you should key in the
  1481.                       path/name to THE EDITED COPY of CONFMAIL.DEF that you
  1482.                       created a few pages back.
  1483.                       
  1484.                       MailCFG will then step through your CONFMAIL.DEF and set
  1485.                       things up for Mail Manager +Plus+'s use.  The TWO
  1486.                       REQUIREMENTS for using CONFMAIL.DEF is that your MAIN
  1487.                       message base absolutely *MUST* be the first conference
  1488.                       listed, and each line in your CONFMAIL.DEF must list the
  1489.                       FULL path\filename to the conference!
  1490.  
  1491.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 28 -
  1492.  
  1493.  
  1494.             
  1495.             M)anual - Will create a default configuration file, and require you
  1496.                       to manually add all of your conference information.
  1497.                       
  1498.                       If you have FIDO *.MSG conferences to add to your Mail
  1499.                       Manager +Plus+ configuration, and would like to auto-
  1500.                       import them in the same manner as above, you should first
  1501.                       set up all of your RBBS-PC *M.DEF areas via CONFMAIL.DEF
  1502.                       as above, read through this section so that you will know
  1503.                       what each option is for, and then read up on the section
  1504.                       of this document specific to FIDO *.MSG message areas.
  1505.          
  1506.          Now let's talk about MAILCFG.EXE itself.
  1507.          
  1508.          There are four main screens.  Use the cursor keys to move around in
  1509.          each one.  [Esc] always takes you back to the previous level. [PgUp]
  1510.          and [PgDn] usually lets you switch screens.  Starting on the next
  1511.          page, we'll take each one individually.
  1512.  
  1513.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 29 -
  1514.  
  1515.  
  1516.          ---------------------------------------------------------------------
  1517.               MAILCFG SCREEN 1 - GENERAL CONFIGURATION (Screen #1 of 3):
  1518.          ----------------------------------------------------------------------
  1519.          
  1520.          Unless you're configuring Mail Manager +Plus+ for the first time, this
  1521.          is the screen that pops up when you load MAILCFG.  It looks something
  1522.          like this:
  1523.          
  1524.            Name of your BBS................ : RBBS-PC
  1525.            Remote Sysop Name............... : SECRET LOGONNAME
  1526.            Sysop First Name................ : SYSTEM
  1527.            Sysop Last Name................. : OPERATOR
  1528.            Security to read ALL messages... : 10
  1529.            Security to use in local mode... : 10
  1530.            Use ANSI graphics in local mode? : Y
  1531.            Tagline : Your friendly neighborhood RBBS-PC - (123) 555-1212
  1532.            Network type (local mode only).. : DOS
  1533.            Filename to use for extracts.... : RBBS-PC
  1534.            Default file compression........ : ZIP
  1535.            Path/Name of your NEWS file .... : C:\RBBS\MAIN.NWS
  1536.            Path/Name of your FMS directory. : C:\RBBS\MASTER.DIR
  1537.            Handshake method (F, R, X, N)... : XON/XOFF
  1538.          
  1539.              Next Screen       Edit Conference selections          Exit
  1540.          
  1541.          ----------------------------------------------------------------------
  1542.          
  1543.          Now to take these one at a time:
  1544.          
  1545.            - Name of your BBS................ :
  1546.          
  1547.                  This should be the name of your board as set in RBBS CONFIG.
  1548.                  You can stick anything in here, however.  This name will be
  1549.                  shown to the user several times, and will be shown in the
  1550.                  offline mail reader as the board name.
  1551.          
  1552.            - Remote Sysop Name............... :
  1553.          
  1554.                  This *MUST* be the full name that you use to log on remotely.
  1555.                  Mail Manager +Plus+ will not operate properly if it cannot
  1556.                  find you (the SysOp) in the various users files.
  1557.          
  1558.            - Sysop First Name................ :
  1559.          
  1560.                  Your first name as you are known to your users.
  1561.          
  1562.            - Sysop Last Name................. :
  1563.          
  1564.                  Your last name as you are known to your users.
  1565.          
  1566.  
  1567.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 30 -
  1568.  
  1569.  
  1570.            - Security to read ALL messages... :
  1571.          
  1572.                  * A VERY IMPORTANT SECURITY LEVEL! *
  1573.                  
  1574.                  This should be set to either SYSOP or CO-SYSOP level only!
  1575.                  Anyone with this security level or higher can read any message
  1576.                  addressed to any user, regardless of whether or not it's
  1577.                  private!
  1578.                  
  1579.                  Mail Manager +Plus+ also uses this security level for most of
  1580.                  it's SysOp-only functions, such as the ability to use the
  1581.                  I)nfo option from Mail Manager +Plus+'s main menu.
  1582.          
  1583.            - Security to use in local mode... :
  1584.                  
  1585.                  Should be set to SYSOP level.  Whenever Mail Manager +Plus+ is
  1586.                  brought up locally, it will use this security level, and the
  1587.                  SysOp name(s) as listed above.
  1588.                  
  1589.            - Use ANSI graphics in local mode? :
  1590.          
  1591.                  Either "Y" or "N", and pretty self-explanatory, I think.
  1592.          
  1593.            - Tagline :
  1594.                  
  1595.                  This can be anything that you'd like to stick on the bottom of
  1596.                  all messages.  (Usually a very brief BBS advertisement).  If
  1597.                  this is left blank (or "NONE"), Mail Manager will not append a
  1598.                  tagline to the bottom of each message that the user downloads.
  1599.                  
  1600.                  Please note that taglines can be different in each conference.
  1601.                  This is simply what you use as a default.
  1602.          
  1603.            - Network type (local mode only).. :
  1604.          
  1605.                  This setting affects local operation only.  Valid settings
  1606.                  are:
  1607.          
  1608.                    D = DOS - No file/record locking in place.
  1609.                    Q = DESQview - Use DESQview resource locking.
  1610.                    N = NetBIOS - Use NetBIOS file/record locking, and
  1611.                         implement file sharing.  Unless you're running
  1612.                         in a Novell network, this option requires that
  1613.                         DOS SHARE be installed.
  1614.          
  1615.                  Type of network is fully explained elsewhere in this document.
  1616.          
  1617.  
  1618.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 31 -
  1619.  
  1620.  
  1621.            - Filename to use for extracts.... :
  1622.          
  1623.                  Specify up to 8 characters here.  All downloaded files will
  1624.                  begin with this filename.  You might want to abbreviate your
  1625.                  board name here to make it clearer to the users once they've
  1626.                  downloaded their file(s).
  1627.                  
  1628.                  Using "MYBBS" for an example, QWK downloads would be named
  1629.                  MYBBS.QWK, and text extracts would be named MYBBS.ZIP, ARJ,
  1630.                  etc.
  1631.                  
  1632.                  Also, all uploaded replies will be expected to have this
  1633.                  filename, with the extension ".REP".  Any uploads that don't
  1634.                  have an exact match on filename are ignored.
  1635.                  
  1636.            - Default file compression........ :
  1637.          
  1638.                  Must be three characters, and one of the following:
  1639.                  
  1640.                     ARC - Use Katz's PKARC.
  1641.                     ARJ - Use Jung's ARJ.
  1642.                     LZH - Use Yoshi's LHARC.
  1643.                     ZIP - Use Katz's PKZIP/PKUNZIP.
  1644.                  
  1645.                  Unless you use Mail Manager +Plus+'s list of archivers, all
  1646.                  downloads will be compressed using this format, and all
  1647.                  uploads will be expected to be in this format.  The archiver
  1648.                  of your choice absolutely *MUST* be in a DOS path if you are
  1649.                  not using the list of archivers!  Just sticking it in the Mail
  1650.                  Manager directory won't do.  If you are using the list of
  1651.                  archivers, Mail Manager will use the archiver list to
  1652.                  determine how to call the archiver.
  1653.                  
  1654.            - Path/Name of your NEWS file.... :
  1655.                  
  1656.                  Type in the full path to the *NON-GRAPHIC VERSION* of your
  1657.                  RBBS-PC news file (usually MAIN.NWS in your RBBS-PC bulletin
  1658.                  directory).  If the user is using ASCII or ANSI graphics, Mail
  1659.                  Manager +Plus+ will automatically attempt to pick up the
  1660.                  appropriate graphic version of this file for them.  If this
  1661.                  file is newer than the user's last logon, it will be included
  1662.                  in their QWK packets.  Otherwise it will be skipped when their
  1663.                  QWK packet is created.
  1664.          
  1665.            - Path/Name of your FMS directory :
  1666.          
  1667.                  If you are using an RBBS-standard FMS directory, and would
  1668.                  like to make a list of new files available to your users
  1669.                  (since their last trip into the Mail Manager door), key in the
  1670.                  full path/filename of your FMS directory here.  If you do not
  1671.                  want to use this option, leave this blank, or key in the word
  1672.                  "NONE" (with no quotes).
  1673.          
  1674.  
  1675.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 32 -
  1676.  
  1677.  
  1678.            - Handshake method (F, R, X, N)... :
  1679.                  
  1680.                  Allows you to specify the type of flow control that you'd like
  1681.                  Mail Manager +Plus+ to use.  The four possible settings are as
  1682.                  follows:
  1683.                  F = FOSSIL  Mail Manager will always try to use a FOSSIL with
  1684.                         this setting.  If Mail Manager +Plus+ is unable (for
  1685.                         whatever reason) to initialize your FOSSIL driver, it
  1686.                         will default to XON/XOFF.
  1687.                         
  1688.                  R = RTS/CTS    (Use request to send/clear to send)
  1689.                  X = XON/XOFF   (Use XON/XOFF)
  1690.                  N = NONE       (No handshaking)
  1691.                  
  1692.                  If set to R, X, or N:
  1693.                     
  1694.                     The FOSSIL argument is passed to Mail Manager from RBBS-PC
  1695.                     in the DORINFOx.DEF file.  If Mail Manager finds that a
  1696.                     FOSSIL is active in RBBS-PC, it will automatically attempt
  1697.                     to utilize the FOSSIL, regardless of this setting.
  1698.                     
  1699.                     Mail Manager will default back to this setting if it is
  1700.                     unable to use your FOSSIL driver.
  1701.                  
  1702.                  Use of a FOSSIL with Mail Manager is further explained
  1703.                  elsewhere in this document.
  1704.          
  1705.            - Next Screen
  1706.          
  1707.                  Position the cursor over this option, press [ENTER], and you
  1708.                  will be taken to the second general configuration screen.
  1709.          
  1710.            - Edit Conference selections
  1711.          
  1712.                  Position the cursor over this option, press [ENTER], and you
  1713.                  will be taken to the conference selection screen.
  1714.          
  1715.            - Exit
  1716.          
  1717.                  Position the cursor over this option and press [ENTER] (or
  1718.                  press [Esc] from anywhere on this screen), and you'll be asked
  1719.                  to save your configuration before MAILCFG exits to DOS.
  1720.          
  1721.          Thus endeth screen #1.
  1722.  
  1723.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 33 -
  1724.  
  1725.  
  1726.          ----------------------------------------------------------------------
  1727.               MAILCFG SCREEN 2 - GENERAL CONFIGURATION (Screen #2 of 3):
  1728.          ----------------------------------------------------------------------
  1729.          
  1730.          This screen should look something like this:
  1731.          
  1732.            Path/Name of your bulletin list. : C:\MAILMGR\MAILMGR.BUL
  1733.            Path/Name of protocol definitions: C:\MAILMGR\MAILMGR.PRO
  1734.            Path/Name of list of archivers...: C:\MAILMGR\MAILMGR.ARL
  1735.            Environment variable to check....: DSZLOG
  1736.            Modify uploaded msgs date/time? .: No
  1737.            Location of your BBS.............: Anytown, USA
  1738.            BBS Phone number (xxx-xxx-xxxx)..: 123-456-7890
  1739.            Smart text character (1-255).....: 123
  1740.            Default path to RBBS-PC msg bases: C:\RBBS\
  1741.            Log file for FIDO conferences....: NONE
  1742.            Door is timelocked from (xx:xx)..: 00:00
  1743.                                 to (xx:xx)..: 00:00
  1744.            Allow G)oodbye to drop DTR? .....: No
  1745.            Show empty conferences? .........: Yes
  1746.          
  1747.             Previous Screen   Next Screen   Edit Conference selections   Exit
  1748.          
  1749.          ----------------------------------------------------------------------
  1750.          
  1751.          Now to take these one at a time:
  1752.          
  1753.            - Path/Name of your bulletin list :
  1754.          
  1755.                  Type in the full path to your list of bulletins that you would
  1756.                  like to include to your users in their QWK packets.  This is a
  1757.                  text file, and simply lists the paths and names of the *NON-
  1758.                  GRAPHIC VERSIONS* of your commonly updated bulletins. (The
  1759.                  door will automatically pick up the ASCII or ANSI versions of
  1760.                  your bulletins, depending on the user's graphic preference).
  1761.                  The default is MAILMGR.BUL in a directory named C:\MAILMGR.
  1762.                  This file should look something like this:
  1763.                  
  1764.                    C:\RBBS\BULLET1
  1765.                    C:\RBBS\BULLET2
  1766.                    C:\RBBS\BULLET3
  1767.                    **C:\RBBS\ALWAYS.BUL
  1768.                  ... etc.
  1769.                  
  1770.                  The date stamp on these files will be checked against the last
  1771.                  logon date of the user, and if they are determined to be the
  1772.                  same as (or newer than) the user's last logon date, they will
  1773.                  be included in his/her QWK packet.
  1774.                  
  1775.                  Bulletins preceded with a double-asterisk "**" are deemed as
  1776.                  "mandatory for inclusion", and will be included in the user's
  1777.                  mail packets (if they are newer than the user's last date into
  1778.                  the door) regardless of whether or not the user has turned
  1779.                  "off" the ability to receive new bulletins.
  1780.                  
  1781.  
  1782.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 34 -
  1783.  
  1784.  
  1785.                  Bulletins without the leading double-asterisk are deemed as
  1786.                  "optional", and will not be sent to the user if they have
  1787.                  turned "off" the ability to receive new bulletins.
  1788.          
  1789.            - Path/Name of protocol definitions :
  1790.          
  1791.                  Type in the full path to the RBBS-PC PROTO.DEF that you wish
  1792.                  to use with Mail Manager +Plus+.  The supplied file
  1793.                  MAILMGR.PRO allows X, Y, and Zmodem via DSZ.  The very last
  1794.                  protocol letter listed in this file MUST be "N", for none.
  1795.          
  1796.            - Path/Name of list of archivers...:
  1797.          
  1798.                  Type in the full path to Mail Manager +Plus+'s list of
  1799.                  archivers (default is MAILMGR.ARL in the C:\MAILMGR
  1800.                  directory).  If you do not want to give your users the option
  1801.                  of which compression format to use, leave this line blank, or
  1802.                  enter "NONE" (no quotes), and Mail Manager will use only your
  1803.                  default type of file compression.
  1804.                  
  1805.                  See the section of this document entitled "SYSOP-CONFIGURABLE
  1806.                  TEXT FILES" for further details regarding the format of
  1807.                  MAILMGR.ARL.
  1808.                  
  1809.            - Environment variable to check....:
  1810.          
  1811.                  Key in the name of the environment variable that Mail Manager
  1812.                  +Plus+ is to check to determine where to look for "XFER-
  1813.                  x.DEF".  Most of us seem to be using Forsberg's DSZ for
  1814.                  transfers, so in this case you would key in the default name
  1815.                  of "DSZLOG".
  1816.                  
  1817.                  When you're finished configuring Mail Manager +Plus+, check
  1818.                  your environment variable to insure that it points to XFER-
  1819.                  x.DEF.  Without XFER-x.DEF, Mail Manager +Plus+ will assume
  1820.                  that all file transfers have failed.
  1821.          
  1822.  
  1823.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 35 -
  1824.  
  1825.  
  1826.            - Modify uploaded msgs date/time?
  1827.          
  1828.                  Either "Y" or "N".  Setting to "Y" tells Mail Manager +Plus+
  1829.                  to use your computer's current system date and time for all
  1830.                  uploaded replies.  Setting to "N" tells Mail Manager +Plus+ to
  1831.                  use the date and time stamp as it was received in the uploaded
  1832.                  reply packet.
  1833.          
  1834.                  Advantage:  Having Mail Manager +Plus+ modify this field
  1835.                      assures that all uploaded messages will have the correct
  1836.                      date and time stamp applied before inserting into your
  1837.                      message base(s).
  1838.                  
  1839.                  Disadvantage:  If a user uploads several replies in the same
  1840.                      mail packet (many do), some mail networks (like FIDO-NET)
  1841.                      will have trouble with several messages containing the
  1842.                      exact same date & time stamp, and will likely refuse
  1843.                      everything but the first msg of the "offending" group.  If
  1844.                      you're a member of one of these networks, you'll probably
  1845.                      want to take the date/time stamp as-received from the
  1846.                      user.
  1847.          
  1848.            - Location of your BBS
  1849.          
  1850.                  The City, State in which your system is located.  This is
  1851.                  added to the CONTROL.DAT file that is included in all QWK
  1852.                  packets, is part of the QWK standard, and is not used anywhere
  1853.                  else by Mail Manager +Plus+.
  1854.          
  1855.            - BBS Phone number (xxx-xxx-xxxx)
  1856.          
  1857.                  The phone number to your system.  This is also added to the
  1858.                  CONTROL.DAT file that is included in all QWK packets, is part
  1859.                  of the QWK standard, and is not used anywhere else by Mail
  1860.                  Manager +Plus+.
  1861.          
  1862.            - Smart text character (1-255)
  1863.          
  1864.                  The ASCII value of the "lead-in" character for RBBS-PC smart
  1865.                  text.  RBBS-PC default for this value is "123", which is the
  1866.                  "{" character.  This value must match what you are using with
  1867.                  RBBS-PC, or smart text in bulletins and news files will not be
  1868.                  converted properly.
  1869.                  
  1870.                  Mail Manager +Plus+ will attempt to replace all possible
  1871.                  "smart text" variables with their true values in bulletins and
  1872.                  news files.
  1873.                  
  1874.            - Default path to RBBS-PC msg bases
  1875.                  
  1876.                  This should be set to the path where your *M.DEF message bases
  1877.                  are located.  MAILCFG.EXE will then attempt to save you some
  1878.                  keyboard entry time by "guessing" the true path/filename of
  1879.                  all conferences entered manually.
  1880.                  
  1881.  
  1882.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 36 -
  1883.  
  1884.  
  1885.                  For instance, if this value is set to "C:\RBBS\", and you
  1886.                  configure a conference named BBSADS, MAILCFG.EXE will "guess"
  1887.                  the path/name of the users file as:
  1888.                  
  1889.                      C:\RBBS\BBSADSU.DEF
  1890.                  
  1891.            - Log file for FIDO conferences
  1892.                  
  1893.                  This is an optional argument, and pertains only to sysops who
  1894.                  have configured FIDO-style "*.MSG" areas into Mail Manager
  1895.                  +Plus+.  If this path/filename is set to anything other than
  1896.                  "NONE", Mail Manager +Plus+ will append this text file with
  1897.                  the FIDO-style area names of all "*.MSG" conferences that the
  1898.                  user uploaded messages to.
  1899.                  
  1900.                  For instance... if the user uploaded 3 messages to area name
  1901.                  "RBBS-PC", two messages to "HS_MODEMS", and 1 message to "FOR-
  1902.                  SALE", the resulting log file would be appended with:
  1903.                  
  1904.                      RBBS-PC
  1905.                      HS_MODEMS
  1906.                      FOR-SALE
  1907.                  
  1908.                  Your system's batch files can then take care of any necessary
  1909.                  external mail processing based on the contents of this file.
  1910.          
  1911.            - Door is timelocked from (xx:xx)
  1912.                                   to (xx:xx)
  1913.                  
  1914.                  If you run an echomail system, there may be certain times of
  1915.                  the day that you do not want your users into your message
  1916.                  bases.  These two arguments tell Mail Manager +Plus+ when to
  1917.                  disallow access to the door. To disable, set the "from" and
  1918.                  "to" times identically.  For example:  00:00  to  00:00  would
  1919.                  let users into the door 24 hours a day.
  1920.                  
  1921.                  Users with sufficient security to read ALL messages are
  1922.                  allowed into the door during the time lock, after receiving a
  1923.                  brief warning message.  All other users attempting to access
  1924.                  the door during the timelock will be informed that you are
  1925.                  processing mail, and will be asked to try again later.
  1926.          
  1927.            - Allow G)oodbye to drop DTR?
  1928.          
  1929.                  Either "Y" or "N".  If set to "Y", the door will drop DTR when
  1930.                  the user selects G)oodbye from the menu, and also after an
  1931.                  E)xpedite! mail session.
  1932.                  
  1933.                  If set to "N", the G)oodbye command will not be supported, and
  1934.                  "G" will not show on the command line.  E)xpedite! will return
  1935.                  the user to the BBS after the user's packet is downloaded.
  1936.                  
  1937.                  If you chose "N" to disable the G)oodbye command, you should
  1938.                  edit the menu and help text files to remove the "G)oodbye"
  1939.                  option.
  1940.  
  1941.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 37 -
  1942.  
  1943.  
  1944.                  
  1945.                 ***************************************************************
  1946.                 *  WARNING!  - If you have elected to allow the door to drop  *
  1947.                 *              DTR, do *NOT* have your modem in autoanswer    *
  1948.                 *  mode!  If you do, it will be possible (although unlikely)  *
  1949.                 *  for a 2nd user to call and connect in the "window" between *
  1950.                 *  the door dropping carrier, and when RBBS recovers.  In     *
  1951.                 *  this case, it is conceivable that this 2nd user could      *
  1952.                 *  receive a "Welcome back!" message from RBBS, and your      *
  1953.                 *  board would think that the PREVIOUS user just returned     *
  1954.                 *  from the door.  As you can see, this could be dangerous.   *
  1955.                 *  You have been warned!                                      *
  1956.                 ***************************************************************
  1957.          
  1958.            - Previous Screen
  1959.          
  1960.                  Position the cursor over this option, press [ENTER], and you
  1961.                  will be taken to the first general configuration screen.
  1962.          
  1963.            - Next Screen
  1964.          
  1965.                  Position the cursor over this option, press [ENTER], and you
  1966.                  will be taken to the third  general configuration screen.
  1967.          
  1968.            - Edit Conference selections
  1969.          
  1970.                  Position the cursor over this option, press [ENTER], and you
  1971.                  will be taken to the conference selection screen.
  1972.                  
  1973.            - Exit
  1974.          
  1975.                  Position the cursor over this option and press [ENTER] (or
  1976.                  press [Esc] from anywhere on this screen), and you'll be asked
  1977.                  to save your configuration before MAILCFG exits to DOS.
  1978.          
  1979.          Thus endeth screen #2.
  1980.  
  1981.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 38 -
  1982.  
  1983.  
  1984.          ----------------------------------------------------------------------
  1985.                          MAILCFG SCREEN #3
  1986.          ----------------------------------------------------------------------
  1987.          
  1988.          At this stage of development, there are only three configuration
  1989.          options on this screen, other than the ones that control where to go
  1990.          next from this screen:
  1991.          
  1992.          
  1993.           - Max number of msgs per packet
  1994.                  
  1995.                  When extracting messages, if this number is reached,
  1996.                  extraction will stop and the packet will be archived and sent.
  1997.                  If additional new messages still remain, the user can extract
  1998.                  an additional packet to get them.
  1999.                  
  2000.                  Note that the number set here will have an effect on the
  2001.                  amount of memory necessary to run the door, and the amount of
  2002.                  disk space needed to create the working files when extracting.
  2003.                  If you do not set this, a default of 1000 will be assumed.
  2004.          
  2005.           - Make violation conference mandatory
  2006.                  
  2007.                  If set to "Y", all users will receive messages in this
  2008.                  conference in their packets.  They will not be able to
  2009.                  "deselect" this conference.  A number of sysops have requested
  2010.                  that we make the MAIN conference mandatory, and this is the
  2011.                  way you can do it.
  2012.                  
  2013.                  NOTE: If you wish a conference other than conference #1 to
  2014.                  receive security violation notices, you may set this via the
  2015.                  /Vnn command line switch.
  2016.          
  2017.           - Allow online R)ead and P)ost
  2018.          
  2019.                  Either "Y" or "N".  If set to "N", the "R" and "P" options
  2020.                  will be removed from the main command prompt, and the user who
  2021.                  chooses one of those two options will receive the familiar
  2022.                  "Command not recognized" message.
  2023.                  
  2024.                  If set to "Y", online read and post are allowed, and those two
  2025.                  options will be available.
  2026.                  
  2027.                  Sysops who disallow online R)ead and P)ost should edit the
  2028.                  MAILMGRx.MNU menus as well as the online help files
  2029.                  (MMGR*.HLP) to remove all mention of these two options.
  2030.          
  2031.            - Previous Screen
  2032.          
  2033.                  Position the cursor over this option, press [ENTER], and you
  2034.                  will be taken to the second general configuration screen.
  2035.          
  2036.  
  2037.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 39 -
  2038.  
  2039.  
  2040.            - Edit Conference selections
  2041.          
  2042.                  Position the cursor over this option, press [ENTER], and you
  2043.                  will be taken to the conference selection screen.
  2044.                  
  2045.            - Exit
  2046.          
  2047.                  Position the cursor over this option and press [ENTER] (or
  2048.                  press [Esc] from anywhere on this screen), and you'll be asked
  2049.                  to save your configuration before MAILCFG exits to DOS.
  2050.          
  2051.          Thus endeth screen #3.
  2052.  
  2053.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 40 -
  2054.  
  2055.  
  2056.          ----------------------------------------------------------------------
  2057.                          MAILCFG SCREEN #4 - CONFERENCE SELECTION
  2058.          ----------------------------------------------------------------------
  2059.          
  2060.          This screen should look something like this:
  2061.          
  2062.              1 MAIN       11            21            31            41
  2063.              2            12            22            32            42
  2064.              3            13            23            33            43
  2065.              4            14            24            34            44
  2066.              5            15            25            35            45
  2067.              6            16            26            36            46
  2068.              7            17            27            37            47
  2069.              8            18            28            38            48
  2070.              9            19            29            39            49
  2071.             10            20            30            40            50
  2072.          ----------------------------------------------------------------------
  2073.          
  2074.                              CONFERENCE SELECTION SCREEN
  2075.          
  2076.                      Use cursor keys to select a conference to edit.
  2077.          
  2078.                            [ENTER] = Edit this conference.
  2079.                             [PgUp] = Move to previous screen.
  2080.                             [PgDn] = Move to next screen.
  2081.                              [Esc] = Finished editing.
  2082.          
  2083.          ----------------------------------------------------------------------
  2084.          
  2085.          You can use the cursor keys, [PgUp], and [PgDn] to switch between all
  2086.          of the different conferences possible.  You can configure as many as
  2087.          500 conferences.  Position the cursor over the conference that you
  2088.          wish to edit, press [ENTER], and you will be taken to the conference
  2089.          edit screen.
  2090.          
  2091.          **********************************************************************
  2092.          *  It is VERY IMPORTANT to have your MAIN message area as the first  *
  2093.          *  conference listed, and that ALL MAIL MANAGER +PLUS+ USERS have    *
  2094.          *  sufficient security to at least READ in this area!  Mail Manager  *
  2095.          *  +Plus+ uses this internally for some of its functions.            *
  2096.          **********************************************************************
  2097.          
  2098.          Press [Esc] (or [PgUp]) when you're finished editing your conferences,
  2099.          and you'll be taken back to general configuration screen #2.
  2100.  
  2101.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 41 -
  2102.  
  2103.  
  2104.          ----------------------------------------------------------------------
  2105.                             MAILCFG SCREEN #4 - CONFERENCE EDIT
  2106.          ----------------------------------------------------------------------
  2107.          
  2108.          Once you've pressed [ENTER] at the conference selection screen, up
  2109.          will pop something that looks like this:
  2110.          
  2111.                                     Editing Conference #1
  2112.              Conference name .............................: MAIN
  2113.              Conference description ......................: Main message base
  2114.              FIDO area name ..............................: N/A
  2115.              Message base type: Y=Fixed, N=Elastic, F=Fido: N
  2116.              Path/Name of conference USERS file:
  2117.                   C:\RBBS\MAINU.DEF
  2118.              Path/Name of conference MESSAGES file:              Fakenet: N/A
  2119.                   C:\RBBS\MAINM.DEF
  2120.              Allow ANSI graphics in uploaded messages? ...: Y
  2121.              Allow high & low ASCII in uploaded messages? : Y
  2122.              Security level to READ this conference ......: 5
  2123.              Security level to POST in this conference ...: 5
  2124.              Tagline for this conference:                        Add tag: N/A
  2125.                   NONE
  2126.              Use Fido-style tearlines? ...................: N       Zone: N/A
  2127.              Allow users to join within Mail Manager? ....: N        Net: N/A
  2128.              Maximum # of lines per message ..............: 99      Node: N/A
  2129.              Path/Name of conference ALIAS file:                   Point: N/A
  2130.                   NONE                                           Netmail: N/A
  2131.          
  2132.          Press [Esc] or [F10] when finished with the conference, [F1] for help.
  2133.          ----------------------------------------------------------------------
  2134.          
  2135.          Several of these options pertain only to FIDO *.MSG areas, and some
  2136.          have different meaning to FIDO *.MSG areas.  We will attempt to cover
  2137.          each one individually as completely as possible:
  2138.          
  2139.            - Conference Name
  2140.          
  2141.                  Up to 7 characters that you will use to describe this
  2142.                  conference to the users.  Normally set as the first 7
  2143.                  characters of the name of the MESSAGES and USERS file,
  2144.                  although you can put anything in here.  For FIDO *.MSG areas,
  2145.                  you will want to match this as closely as possible to the true
  2146.                  FIDO-style area name of the conference, since this is what
  2147.                  will be displayed to the users.
  2148.                  
  2149.                  The important thing is to describe the conference as fully as
  2150.                  possible (for the users) in the 7 characters that you have
  2151.                  available.  The 25-character conference description will
  2152.                  describe it for them a lot better.
  2153.                  
  2154.                  If the conference name is left blank, or it is set to
  2155.                  "{EMPTY}", pressing [F10] will cause MAILCFG to ask you
  2156.                  whether or not to reserve a space for this conference number.
  2157.                  If you do NOT reserve the space, this conference number will
  2158.                  be skipped when you save your settings.
  2159.  
  2160.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 42 -
  2161.  
  2162.  
  2163.            - Conference description
  2164.          
  2165.                  Up to 25 characters that you will use to more fully describe
  2166.                  the conference to the users.  This field will be (optionally)
  2167.                  shown to the users when they are configuring which conferences
  2168.                  to follow within the door, and also when selecting conferences
  2169.                  in which to R)ead or P)ost a message.
  2170.                  
  2171.                  If the user is in expert mode, the default is to NOT show the
  2172.                  conference descriptions.  If in novice mode (display the
  2173.                  menus), the default is to show conference descriptions.  The
  2174.                  user is given a choice at all times.
  2175.                  
  2176.                  When displaying conference descriptions, the user will see 15
  2177.                  conferences on each screen.  When NOT displaying descriptions,
  2178.                  the user will see 50 conferences per screen.
  2179.                  
  2180.            - FIDO area name
  2181.          
  2182.                  Pertains only to FIDO *.MSG areas, and optional.  If not a
  2183.                  FIDO *.MSG area, this field will be skipped.
  2184.                  
  2185.                  This should be set to the exact FIDO-style area name of the
  2186.                  conference, as your external mail processor knows it.  This
  2187.                  name is used ONLY when appending the optional log file, as set
  2188.                  in the general configuration.
  2189.          
  2190.            - Path/Name of conference USERS file
  2191.          
  2192.                  Full path to your RBBS-PC users file for this conference.
  2193.                  
  2194.                  A quick note here:  You really should have a unique USERS file
  2195.                  for each conference/subboard.  RBBS-PC does not absolutely
  2196.                  require this, but it is necessary to keep the last message
  2197.                  read in each conference updated, and for Mail Manager to know
  2198.                  exactly which messages to extract and prepare to download for
  2199.                  the users.
  2200.                  
  2201.                  If this is a FIDO *.MSG area, this setting has no meaning to
  2202.                  Mail Manager +Plus+, and you can literally put whatever you
  2203.                  want in here in this case.
  2204.          
  2205.            - Path/Name of conference MESSAGES file
  2206.          
  2207.                  Full path to your RBBS-PC messages file for this conference.
  2208.                  
  2209.                  If this is a FIDO *.MSG area, this must be set to the full
  2210.                  pathname to this area's *.MSG's.  The trailing backslash is
  2211.                  optional.  For example, if set to:
  2212.                  
  2213.                     C:\MAIL\4SALE
  2214.                  
  2215.                  Mail Manager +Plus+ will manipulate files named:
  2216.                  
  2217.                     C:\MAIL\4SALE\*.*
  2218.  
  2219.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 43 -
  2220.  
  2221.  
  2222.                  
  2223.          
  2224.            - Allow ANSI graphics in uploaded messages?
  2225.          
  2226.                  "Y" or "N".  If set to "N", Mail Manager will strip all escape
  2227.                  characters out of uploaded messages, effectively disabling
  2228.                  ANSI.
  2229.          
  2230.            - Allow high & low ASCII in uploaded messages?
  2231.                  
  2232.                  "Y" or "N".  If set to "N", Mail Manager will strip all high
  2233.                  and low ascii characters out of uploaded messages, replacing
  2234.                  them by either blank spaces, or an equivalent "normal"
  2235.                  character.
  2236.                  
  2237.                  The most common reason for disabling both ANSI and ASCII is to
  2238.                  conform to FIDO-NET rules & regs, although there are several
  2239.                  reasons why you might want to disable ANSI.
  2240.          
  2241.            - Security level to READ this conference
  2242.          
  2243.                  Minimum security level required to see this conference listed
  2244.                  in Mail Manager's configuration menu.  If the user does not
  2245.                  have sufficient security to READ this conference, the
  2246.                  conference name will be replaced by " --- " in Mail Manager's
  2247.                  menu, and the user will not be allowed to download messages
  2248.                  (or upload replies) in this conference.
  2249.          
  2250.            - Security level to POST in this conference
  2251.          
  2252.                  Minimum security level required to leave a message in this
  2253.                  conference.  If the user's security level is lower than this,
  2254.                  yet the same as (or higher than) the security required to
  2255.                  READ, any messages that he/she uploads to this conference will
  2256.                  result in the following:
  2257.          
  2258.                  ■ A Mail Manager security violation notice being passed back
  2259.                    to the user in the MAIN area, as a private message.  This
  2260.                    message will be shown as being from "MAIL MANAGER".
  2261.                  ■ The uploaded message itself being ignored.  Nothing will be
  2262.                    posted in the conference.
  2263.                  
  2264.            - Tagline for this conference
  2265.          
  2266.                  The tagline that you want to use for this particular
  2267.                  conference.  If set to "NONE", Mail Manager will use the
  2268.                  default tagline.  If the default tagline is also "NONE", no
  2269.                  tagline will be appended to the end of the message.
  2270.                  
  2271.                  If this is a FIDO *.MSG area, this is the origin line that
  2272.                  will be appended to the message if the "Add tag" option is
  2273.                  turned on
  2274.          
  2275.  
  2276.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 44 -
  2277.  
  2278.  
  2279.            - Use FIDO-style tearlines?
  2280.          
  2281.                  During our development of Mail Manager and Mail Manager
  2282.                  +Plus+, there was much discussion to and fro in the various
  2283.                  echos regarding the allowability of mail reader tearlines
  2284.                  ("---").  At this writing, it is not clear as to whether or
  2285.                  not these additional tearlines on echo messages will be
  2286.                  permissible.  In any case, we gave you an out.  Set this to
  2287.                  "Y", and any mail reader tearlines on uploaded messages will
  2288.                  be replaced by three periods ("...").  Set to "N", and
  2289.                  tearlines will be passed into the message untouched.
  2290.          
  2291.            - Type of msg base: Y=Fixed, N=Elastic, F=Fido?
  2292.          
  2293.                  VERY IMPORTANT, and either "Y", "N", or "F".  RBBS-PC and Mail
  2294.                  Manager +Plus+ handle fixed-length conferences differently
  2295.                  from those that are configured to "grow" as messages are
  2296.                  added.
  2297.                  
  2298.                  If set to "F", you are telling Mail Manager +Plus+ that this
  2299.                  is a FIDO *.MSG area, and all of the "N/A"'s that you see on
  2300.                  this screen will be replaced by the current settings.  You
  2301.                  will also be allowed to edit the options specific to FIDO
  2302.                  *.MSG areas.
  2303.                  
  2304.                  Setting this option to "Y" or "N" turns "off" all of the FIDO-
  2305.                  specific options, and replaces their values with "N/A".  None
  2306.                  of the FIDO-specific options will be available for edit.
  2307.          
  2308.            - Allow users to join within Mail Manager?
  2309.          
  2310.                  Either "Y" or "N".  (Has no meaning to FIDO *.MSG areas)
  2311.                  
  2312.                  If set to "Y", Mail Manager +Plus+ will allow your users to
  2313.                  automatically "join" this conference when they attempt to flag
  2314.                  it as active, and will add them to the RBBS conference user
  2315.                  file if they have not joined it from the BBS.
  2316.                  
  2317.                  If set to "N", the user will have to use the J)oin command in
  2318.                  RBBS-PC to become a member of the conference.
  2319.                  
  2320.                  FIDO *.MSG areas cannot be joined from within RBBS-PC, and
  2321.                  can therefore always be "auto-joined" from within Mail Manager
  2322.                  +Plus+, regardless of this setting.
  2323.          
  2324.            - Maximum # of lines per message
  2325.          
  2326.                  Mail Manager itself can handle any length message for
  2327.                  uploading or extracting.  Note that the version of RBBS you
  2328.                  are using may be limited to 99 lines (stock RBBS) or some
  2329.                  larger number in some of the popular modification packages.
  2330.                  
  2331.                  Mail Manager has the capability of splitting long uploaded
  2332.                  messages into several smaller ones when placing them into your
  2333.                  RBBS-style message bases.  The default length is 99 lines per
  2334.  
  2335.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 45 -
  2336.  
  2337.  
  2338.                  message, but you can select any number of lines per message
  2339.                  that you desire for this conference, from 9 to 99.  If you
  2340.                  don't want Mail Manager to split long messages, set this to 0
  2341.                  (zero).
  2342.                  
  2343.                  **************************************************************
  2344.                  *  Note that messages from normal users will be limited to 8 *
  2345.                  *  lines less than this setting, while network packets from  *
  2346.                  *  "net-status" user names will be able to utilize the full  *
  2347.                  *  line limit prior to being split.                          *
  2348.                  **************************************************************
  2349.                  
  2350.                  The door will also use this number when the user attempts to
  2351.                  R)ead, reply, or P)ost a message online, and will not allow
  2352.                  the number of lines to exceed what you specify here.  If "0",
  2353.                  99 lines per message are allowed in R)ead/P)ost online.
  2354.          
  2355.            - Path/Name of conference ALIAS file
  2356.          
  2357.                  There is a popular merge available for RBBS-PC that allows the
  2358.                  use of alias names.  If you are not using the ALIAS merge, you
  2359.                  can still make use of this option, if you would like a few
  2360.                  users to be able to post messages via Mail Manager under a
  2361.                  different name than the one they use on the BBS.  Set this
  2362.                  option to "NONE" if you are not using alias names.
  2363.                  
  2364.                  Since alias names are taboo in the Fido kingdom, this setting
  2365.                  is ignored for Fido *.MSG areas.
  2366.                  
  2367.                  The filename that this option points to is a text file,
  2368.                  formatted as follows:
  2369.                  
  2370.                     REAL NAME, ALIAS NAME
  2371.                  
  2372.                  So, to have all messages uploaded by "JOE DOE" posted as being
  2373.                  from "MAIL ADDICT", and to have the SysOp's own messages
  2374.                  posted as being from "TEST SYSOPNAME", this file would look
  2375.                  like this:
  2376.                  
  2377.                     JOE DOE, MAIL ADDICT
  2378.                     REMOTE NAME, TEST SYSOPNAME
  2379.                  
  2380.                  "REMOTE NAME" would of course be replaced by the name that you
  2381.                  use to sign onto your system remotely.
  2382.                  
  2383.                  Mail Manager +Plus+ is smart enough to take care of updating
  2384.                  the mail waiting flag in RBBS-PC for the REAL NAME of the
  2385.                  recipient, and to add messages addressed to the user's alias
  2386.                  to the personal index of the recipient's mail packets.
  2387.                  
  2388.  
  2389.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 46 -
  2390.  
  2391.  
  2392.                  When a user joins a conference for which there is a defined
  2393.                  alias file, Mail Manager will give the user an opportunity to
  2394.                  select an alias to use.  Mail Manager will not let a user
  2395.                  select an alias already in use in that conference, but it
  2396.                  makes no other checks.  We recommend that you review the alias
  2397.                  files frequently to make sure objectionable names are not
  2398.                  being used.
  2399.          
  2400.            - Fakenet
  2401.          
  2402.                  Applies to FIDO *.MSG areas only.
  2403.          
  2404.                  If you run a point system that utilizes a "Fakenet" network
  2405.                  address, then you may want to make use of this argument for
  2406.                  your netmail area(s).  This option will cause the door to set
  2407.                  the Fido message header properly for your fakenet, and your
  2408.                  mail processor will take care of the rest.  MMGR+ creates type
  2409.                  2+ mail packets and messages, meaning that it puts both the
  2410.                  Zone and Point numbers into the message header where your mail
  2411.                  processor can deal with it.  This option is therefore NOT
  2412.                  NEEDED if your mail processing software can handle 4D points.
  2413.                  Here is exactly what this option does (by example):
  2414.          
  2415.                                   Add Tag: Yes
  2416.                                   Fakenet: 31226
  2417.                                      Zone: 1
  2418.                                       Net: 226
  2419.                                      Node: 1400
  2420.                                     Point: 2
  2421.          
  2422.                  At the bottom of the message, your tear and origin line would
  2423.                  look something like:
  2424.          
  2425.                     --- MMGR +Plus+ v3.51
  2426.                      * Origin: Makai support node (1:226/1400.2)
  2427.                  
  2428.                  But, your address in the message header itself would read:
  2429.          
  2430.                                   1:31226/2
  2431.                                   |    |  |
  2432.                                   Zone |  |
  2433.                                        |  |
  2434.                                   Fakenet |
  2435.                                           |
  2436.                                           Point
  2437.          
  2438.                  That's really all there is to it.  If your mail processor
  2439.                  doesn't need things this way, don't worry about it.  Just set
  2440.                  the "Fakenet" to zero.  Mail Manager +Plus+ can handle fakenet
  2441.                  numbers up to 32767.
  2442.          
  2443.  
  2444.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 47 -
  2445.  
  2446.  
  2447.            - Add tag
  2448.          
  2449.                  Applies to FIDO *.MSG areas only.
  2450.                  
  2451.                  If set to "Y", Mail Manager +Plus+ will append a tear and
  2452.                  origin line to messages uploaded to this conference, such as:
  2453.                  
  2454.                  --- MMGR+ v3.51
  2455.                   * Origin: [Tagline for this conference] (Zone:Net/Node.Point)
  2456.                  
  2457.                  If set to "N", the tear/tag is *NOT* appended to the uploaded
  2458.                  messages.  (Normally, this is a function of your mail
  2459.                  processor, but you may want Mail Manager +Plus+ to append
  2460.                  these lines in your NETMAIL areas).
  2461.                  
  2462.            - Zone
  2463.                  
  2464.                  Applies to FIDO *.MSG areas only.
  2465.                  
  2466.                  FIDO-NET is normally "1", RBBS-NET is normally "8".  Each
  2467.                  conference can be set to different Zone:Net/Node arguments, so
  2468.                  Mail Manager +Plus+ allows you to be in MANY different mail
  2469.                  zones!
  2470.                  
  2471.            - Net
  2472.                  
  2473.                  As above, applies to FIDO *.MSG areas only.
  2474.                  
  2475.                  Set this to the net number you are using for this conference.
  2476.                  
  2477.            - Node
  2478.                  
  2479.                  As above, applies to FIDO *.MSG areas only.
  2480.                  
  2481.                  Set this to the node number you are using for this conference.
  2482.                  For these three options, settings of:
  2483.                  
  2484.                                   Zone: 8
  2485.                                    Net: 965
  2486.                                   Node: 9
  2487.                  
  2488.                  ...would mean a FIDO-style address of "8:965/9".
  2489.                  
  2490.            - Point
  2491.                  
  2492.                  As above, applies to FIDO *.MSG areas only.
  2493.                  
  2494.                  If you are operating a point system, set this to your point
  2495.                  number that you are using for this conference.  If you are not
  2496.                  operating as a point, set this option to 0 (zero).
  2497.                  
  2498.  
  2499.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 48 -
  2500.  
  2501.  
  2502.                  For these last four options, settings of:
  2503.                  
  2504.                                    Zone: 8
  2505.                                     Net: 965
  2506.                                    Node: 9
  2507.                                   Point: 1
  2508.                  
  2509.                  ...would mean a FIDO-style address of "8:965/9.1"
  2510.                  
  2511.          
  2512.            - Netmail
  2513.          
  2514.                  Applies to FIDO *.MSG areas only.
  2515.                  
  2516.                  THIS IS A VERY IMPORTANT SETTING.  If this is a netmail area,
  2517.                  set it to "Y", otherwise DEFINITELY set it to "N"!  Mail
  2518.                  Manager +Plus+ handles netmail areas quite differently than
  2519.                  standard *.MSG echo areas, and messages will *NOT* be posted
  2520.                  properly if this setting is incorrect.
  2521.                  
  2522.                  Please see the section of this document regarding FIDO *.MSG
  2523.                  areas for all the info on Mail Manager +Plus+'s handling of
  2524.                  netmail areas.
  2525.  
  2526.     CONFIGURING MAIL MANAGER +PLUS+ (MAILCFG.EXE)                   - Page 49 -
  2527.  
  2528.  
  2529.          MULTIPLE CONFIGURATION FILES
  2530.          ----------------------------
  2531.          
  2532.          When Mail Manager +Plus+ loads, it will first look for a node-specific
  2533.          configuration file MAILMGRx.CFG (where x would be the node number).
  2534.          If no node-specific configuration file is found, Mail Manager then
  2535.          defaults back to MAILMGR.CFG.  This permits you to have a separate
  2536.          configuration file for any node that requires one.
  2537.          
  2538.          To edit a configuration file other than the default MAILMGR.CFG, enter
  2539.          the filename on the MAILCFG command line.  For instance, to edit
  2540.          MAILMGR2.CFG, your command might be:
  2541.          
  2542.             MAILCFG C:\MAILMGR\MAILMGR2.CFG
  2543.          
  2544.          MAILCFG will look for and edit the filename MAILMGR.CFG (in the
  2545.          current directory) if nothing is passed on the command line.
  2546.          
  2547.          Please be aware that Mail Manager +Plus+ can use the same
  2548.          configuration file between the various nodes of your RBBS-PC, and file
  2549.          sharing/locking is fully implemented.  Therefore it is not necessary
  2550.          to create multiple configuration files unless you have unique
  2551.          requirements between nodes.  (Non-standard port configurations is one
  2552.          example, where you may want to have different MAILMGR.PRO files.
  2553.          Since the path/name of MAILMGR.PRO is specified in the configuration
  2554.          file, this would make for a good argument to use multiple
  2555.          configuration files).
  2556.  
  2557.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 50 -
  2558.  
  2559.  
  2560.          AN INTRODUCTION TO FIDO FORMAT
  2561.          ------------------------------
  2562.          
  2563.          If you do not wish to use FIDO-style *.MSG formatted conferences with
  2564.          Mail Manager +PLUS+, you may skip this section.
  2565.          
  2566.          Mail Manager +PLUS+ merely allows you to access FIDO-style message
  2567.          bases via an offline mail door, it does not handle the actual
  2568.          transmission or reception of these messages.  For that you need a
  2569.          separate frontend mailer such as BinkleyTerm or Front Door.
  2570.          
  2571.          Mail Manager's handling of FIDO conferences is MUCH slower than its
  2572.          handling of RBBS conferences.  You may seriously wish to consider
  2573.          tossing FIDO conferences into standard RBBS message bases in order to
  2574.          speed up Mail Manager operation.  Utilities from other authors for
  2575.          doing this include RBBSMail, MsgToss, and OverMail.  The time spent
  2576.          doing this ONCE for each mail packet received may amount to
  2577.          considerable time savings for EACH time a caller uses this door.
  2578.          
  2579.          Before we talk about the intricacies of setting up Mail Manager +Plus+
  2580.          with your FIDO-style system, we should talk about this particular
  2581.          format for a bit.
  2582.          
  2583.          RBBS-PC is capable of running under a frontend mailer such as Binkley-
  2584.          Term, Frontdoor, Seadog, etc. etc.  Depending on what type of mail
  2585.          processor the Sysop is using, mail can normally be "tossed" into
  2586.          either RBBS-PC message bases, or into the native FIDO-NET format,
  2587.          which is termed here as "*.MSG".  Some Sysops prefer to keep their
  2588.          echo mail in FIDO format, rather than converting all incoming and
  2589.          outgoing messages to and from RBBS-PC *M.DEF's.
  2590.          
  2591.          FIDO "message bases" consist of a unique DOS subdirectory for every
  2592.          conference, with each message in a separate file.  A DOS directory
  2593.          structure for this type of message format will typically look
  2594.          something like this:
  2595.          
  2596.                C:\FIDO        (Base mail directory)
  2597.                C:\FIDO\4SALE  (First conference)
  2598.                C:\FIDO\RBBS   (Second conference)
  2599.                ...            ...so on and so forth.
  2600.          
  2601.          Within each directory (or "conference") will be filenames like 1.MSG,
  2602.          2.MSG, 3.MSG, etc. etc.  The first message in each conference (1.MSG)
  2603.          is normally some type of "checkpoint" file for mail processors (such
  2604.          as QM, et al), and is therefore not usually available for reading by
  2605.          the user.  An exception to this is any "NETMAIL" area that the sysop
  2606.          has set up.  Netmail conferences do not go through quite the same
  2607.          process as regular echo conferences do, and in these types of areas,
  2608.          1.MSG is usually permissible reading material.
  2609.          
  2610.          But let's not get ahead of ourselves, here.  We'll come back to
  2611.          handling netmail later.
  2612.          
  2613.  
  2614.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 51 -
  2615.  
  2616.  
  2617.          Setting up FIDO conferences in Mail Manager is a fairly
  2618.          straightforward process, but there are several things that you will
  2619.          need to keep in mind:
  2620.          
  2621.              - FIDO conferences don't have a user file for Mail Manager +Plus+
  2622.                to rely on.  Therefore, Mail Manager +Plus+ creates one for
  2623.                itself in each FIDO area, named "MMGR.USR".
  2624.              
  2625.              - FIDO conferences don't have any built-in indexing available,
  2626.                short of reading each and every message every time the
  2627.                conference is accessed.  Therefore, Mail Manager +Plus+ creates
  2628.                one for itself in each FIDO area, named "MMGR.NDX".
  2629.              
  2630.              - FIDO conferences cannot be joined from within RBBS-PC.
  2631.                Therefore, Mail Manager +Plus+ will allow every user with
  2632.                sufficient security to read the conference to "join"
  2633.                transparently from within the door.
  2634.              
  2635.              - FIDO conferences are usually renumbered every night.  This means
  2636.                that what was message number 175 on one day might become message
  2637.                number 37 on the next.  Mail Manager therefore determines a
  2638.                unique CRC for each message, based on selected unchanging
  2639.                portions of each message header.  This information is stored in
  2640.                the "MMGR.NDX" file within each conference.
  2641.              
  2642.              - This index should be updated right after your
  2643.                renumbering/maintenance event, to save the first hapless user a
  2644.                *LOT* of time while Mail Manager +Plus+ re-creates it.  That's
  2645.                what the supplied MMINDEX.EXE program is for, and we'll get into
  2646.                the usage of this program shortly.
  2647.              
  2648.              - Mail Manager must know your Zone:Net/Node ID for each FIDO
  2649.                conference, so that it can properly create the message headers
  2650.                of all uploaded replies to these areas.
  2651.              
  2652.          SETTING UP YOUR FIRST FIDO *.MSG AREA
  2653.          -------------------------------------
  2654.          
  2655.          With all that in mind, try setting up your first FIDO conference in
  2656.          Mail Manager +Plus+.  Make sure that it is working properly before you
  2657.          add the entire slew of conferences!  At MAILCFG's conference edit
  2658.          screen, there are several options unique to FIDO conferences that are
  2659.          worthy of note:
  2660.          
  2661.              Path/Name of conference USERS file ..:  Ignored by Mail Manager
  2662.                for FIDO conferences.  You can literally put whatever you want
  2663.                in this field.
  2664.              
  2665.              Path/Name of conference MESSAGES file:  This is the DOS PATH to
  2666.                the conference, rather than the name of the *M.DEF file.  For
  2667.                instance, if you enter "C:\MAIL\4SALE", Mail Manager will
  2668.                manipulate files named
  2669.                
  2670.                      "C:\MAIL\4SALE\*.*".  A trailing backslash is optional.
  2671.              
  2672.  
  2673.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 52 -
  2674.  
  2675.  
  2676.              Allow ANSI graphics in uploaded messages? : NO.  FIDO-NET doesn't
  2677.                like ANSI.
  2678.              
  2679.              Allow high & low ASCII .................. : NO.  Moderators will
  2680.                be all over you if they find messages containing high ASCII that
  2681.                originated on your system.
  2682.              
  2683.              Use FIDO-STYLE tearlines? ............... : YES.  This strips out
  2684.                the "---" tearlines that offline readers like to stick on
  2685.                uploaded messages.  Your FIDO-NET mail processor will add a
  2686.                tearline and tag of its own, and duplicate tearlines are taboo
  2687.                in the FIDO kingdom.
  2688.              
  2689.              Message base type: Y=Fixed, N=Elastic, F=FIDO: F
  2690.              
  2691.              Allow users to join within Mail Manager? ....: Ignored by Mail
  2692.                Manager +Plus+ for FIDO areas.  Any user with sufficient
  2693.                security to READ the conference can "join" from within the door.
  2694.              
  2695.              Path/Name of conference ALIAS file? .........: Aliases aren't much
  2696.                good in FIDO land, either.  This setting is ignored for FIDO
  2697.                conferences.  (See the section regarding "CONFIGURING MAIL
  2698.                MANAGER +PLUS+" for more information regarding alias names).
  2699.              
  2700.              Zone:  Set to your mail zone (U.S. FIDO-NET would be 1).
  2701.              Net:   Set to your net ID (the Buckeye Net is 226).
  2702.              Node:  Set to your node ID (the Buckeye Net's host would be 0).
  2703.              Point: Set to your point ID (if applicable).  Point 1 would be 1,
  2704.                     otherwise, set to zero (0).
  2705.                  (These examples would mean an address of 1:226/0.1).
  2706.              
  2707.              Netmail:  VERY IMPORTANT.  If you are configuring a netmail
  2708.                conference, set this option to "Y".  Otherwise, DEFINITELY set
  2709.                it to "N"!
  2710.          
  2711.          Now save your configuration, and as far as Mail Manager +Plus+ is
  2712.          concerned, you just added a FIDO conference.
  2713.          
  2714.          BEFORE YOU EXTRACT MAIL FROM THE CONFERENCE, be sure that there is a
  2715.          file named "1.MSG" in that directory.  Results can be unpredictable if
  2716.          Mail Manager +Plus+ sees only "2.MSG" and up.  Also, remember that
  2717.          there is no Mail Manager +Plus+ index created as of yet.  You'll want
  2718.          to run the MMINDEX.EXE program to initialize the conference for Mail
  2719.          Manager +Plus+'s use.  Although this last is not TRULY necessary, it
  2720.          will speed up initial operation for that conference considerably,
  2721.          especially if it contains a few hundred messages or so.  Usage for
  2722.          MMINDEX:
  2723.          
  2724.              MMINDEX D:\PATH\MAILMGR.CFG [/x] [/Lfilename.log]
  2725.          
  2726.          If no filename is passed on the command line, MMINDEX will look for
  2727.          MAILMGR>CFG in the current directory.
  2728.          
  2729.          To process just one conference, use /x (where x is the conference
  2730.          number to process).
  2731.  
  2732.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 53 -
  2733.  
  2734.  
  2735.          
  2736.          To process only the conferences listed in an echotoss.log-type of
  2737.          file, use "/Lfilename.log", and replace "filename.log" with the
  2738.          full path\filename of the pre-existing log file to process.
  2739.          
  2740.          MMINDEX reads your Mail Manager +Plus+ configuration file, and
  2741.          creates an index file in all of your FIDO conferences (or just
  2742.          the ones you specify with the optional command line arguments).
  2743.          
  2744.          At this point, you're ready to test out the conference from within
  2745.          Mail Manager +Plus+ itself.  When satisfied, you can do one of two
  2746.          things:
  2747.          
  2748.             1) Go back to MailCFG and repeat all but the MMINDEX.EXE step for
  2749.                the rest of your FIDO confs.  Or,
  2750.             
  2751.             2) Run the supplied CFG2TXT utility against your MAILMGR.CFG.  This
  2752.                will create a text file that you can use your favorite text
  2753.                editor against, and add the balance of your FIDO conferences.
  2754.                When finished, run the companion program, TXT2CFG to convert the
  2755.                text file back into Mail Manager +Plus+'s binary configuration
  2756.                format.  If you have MANY Fido conferences to configure, this
  2757.                might be the way to go.
  2758.             
  2759.             See the section of this document regarding "UTILITY PROGRAMS" for
  2760.             more information on these two utilities.
  2761.          
  2762.          After doing one of these two things, run MMINDEX.EXE as the very last
  2763.          item BEFORE firing Mail Manager +Plus+ back up for more testing.
  2764.          Remember to add it to your nightly event, as the very LAST thing run
  2765.          before your BBS comes back up.
  2766.          
  2767.  
  2768.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 54 -
  2769.  
  2770.  
  2771.          NETMAIL CONFERENCES
  2772.          -------------------
  2773.          
  2774.          Guess what!  Netmail areas require a little more work.  "Regular"
  2775.          echomail *.MSG areas are scanned out by your mail processor for
  2776.          sending to your host.  NETMAIL, on the other hand, can be sent
  2777.          anywhere, either directly from your system to destination, or routed
  2778.          through your HOST.
  2779.          
  2780.          The most courteous way to do this is generally thought to be via
  2781.          "Crash" or "Direct" netmail, which bypasses the network and puts you
  2782.          in immediate contact with the individual system.  By going direct,
  2783.          there are other fun things that are considered almost automatic for
  2784.          Sysops of frontend mailer systems, such as "File Attach", and "File
  2785.          Request" (commonly referred to as "FREQ"), not to mention that non-
  2786.          involved parties shouldn't have to front the long distance bill for
  2787.          personal messages between two individuals in the net.
  2788.          
  2789.          On the other hand, if you're sending mail to your host, you might want
  2790.          to send the message normally, which means that it would be sent out
  2791.          when your mail packer picks it up during your regular mail event.
  2792.          This way, you don't have to make two separate (and possibly long-
  2793.          distance) calls to your host if you want to send them netmail.
  2794.          
  2795.          * VERY IMPORTANT NOTE * - In its current state of development, MMGR+
  2796.          can handle outbound crashmail, file attaches, and file requests only
  2797.          when used in conjunction with the BinkleyTerm frontend mailer.  Other
  2798.          front end programs such as FrontDoor, Seadog, D'Bridge, Intermail,
  2799.          etc. etc. use DIFFERENT METHODS of sending off outbound mail packets.
  2800.          For this reason you will be unable to send CRASH netmail with this
  2801.          door unless you are running some variant of BinkleyTerm.  You will be
  2802.          able to send normal (routed) netmail with this door just fine, no
  2803.          matter what frontend you are using.  Regular netmail is picked up by
  2804.          your mail processor, and that is handled the same way for all *.MSG
  2805.          systems.
  2806.          
  2807.          In any case... if you are running BinkleyTerm, you need to inform Mail
  2808.          Manager of your outbound directories for NETMAIL zones, so that you
  2809.          can use the CRASH, file attach and file request options.  This is done
  2810.          via the MMGRNODE.OB text file in your Mail Manager +Plus+ directory.
  2811.          This is a simple text file, and does nothing more than inform the door
  2812.          where to put File requests, File attaches, and outbound netmail when
  2813.          creating a CRASH message.  The format for each line is:
  2814.          
  2815.               Zone, X:\PATH\OUTBOUND.DIR
  2816.          
  2817.          So, if you are in 3 different mail zones, your MMGRNODE.OB file would
  2818.          look something like this:
  2819.          
  2820.               1, C:\BINKLEY\OUTBOUND
  2821.               8, C:\BINKLEY\OUTBOUND.008
  2822.               10, C:\BINKLEY\OUTBOUND.010
  2823.          
  2824.          ...and that's all that's needed for your MMGRNODE.OB text file.
  2825.          
  2826.  
  2827.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 55 -
  2828.  
  2829.  
  2830.          If you are in more than one mail network, you may be using what are
  2831.          termed as "AKA" addresses.  In this case, the Zone:Net/Node address
  2832.          that you configured for this netmail area may not always be what you
  2833.          want Mail Manager +Plus+ to use.  For instance, if you are a member of
  2834.          both Rbbsnet and FidoNet, you may wish to send a message to someone
  2835.          that is reachable only through RBBSNet in zone 8.  In this case, you
  2836.          may want the recipient of the message to see your RBBSNet address on
  2837.          the message, rather than your Fido address.
  2838.          
  2839.          Our solution to this is a file named MMGRNODE.AKA, which Mail Manager
  2840.          +Plus+ will look for in your Mail Manager +Plus+ directory.  This text
  2841.          file is formatted as such for each line:   Zone:Net/Node   So, to copy
  2842.          the above-mentioned example, your MMGRNODE.AKA file might look like:
  2843.          
  2844.              1:226/1400
  2845.              8:965/9
  2846.              10:10/1
  2847.          
  2848.          See the section of this document entitled "Text files for FIDO netmail
  2849.          areas" for the full scoop on MMGRNODE.OB and MMGRNODE.AKA.
  2850.          
  2851.          NOW, we have to get into something that we're probably going to catch
  2852.          flak about, and that's our implementation of how to handle searching
  2853.          the nodelist to find the system to which you're sending netmail
  2854.          messages.
  2855.          
  2856.          Mail Manager +Plus+ uses a proprietary nodelist format.  It just is
  2857.          not feasible at this stage of the game for us to attempt to support
  2858.          Version 6 and/or Version 7 nodelists, so we deemed it best to use a
  2859.          format of our own, optimized for FAST searches and small file size.
  2860.          You need not use our implementation of the nodelist, but if you don't,
  2861.          you will lose convenience, and will then need to be able to enter in
  2862.          the exact Zone, Net, and Node ID of the recipient on every netmail
  2863.          message, with no search options.
  2864.          
  2865.          MMGRNODE.EXE is Mail Manager +Plus+'s proprietary nodelist compiler.
  2866.          This executable should be placed in your Mail Manager +Plus+
  2867.          directory, and should be run whenever you update your nodelists.  Its
  2868.          usage is:
  2869.          
  2870.                MMGRNODE [/A] X:\PATH\NODELIST.FIL
  2871.                   
  2872.                   /A  - Tells Mail Manager +Plus+ to append to the existing
  2873.                         compiled nodelist.  If omitted, Mail Manager +Plus+
  2874.                         will create the compiled nodelist from scratch,
  2875.                         overwriting any pre-existing one. (By "Compiled
  2876.                         nodelist", we are referring to Mail Manager +Plus+'s
  2877.                         proprietary one, MMGRNODE.DAT).
  2878.                   
  2879.                   X:\PATH\NODELIST.FIL - The path/filename to the raw nodelist
  2880.                         that you are compiling.
  2881.          
  2882.  
  2883.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 56 -
  2884.  
  2885.  
  2886.          MMGRNODE will create two files in the current DOS subdirectory:
  2887.          
  2888.                   MMGRNODE.DAT - The main data file containing Sysop names,
  2889.                         Zone, Net, and node numbers, and phone numbers.  All
  2890.                         other information in the raw nodelist is ignored, to
  2891.                         save on file size as much as possible.
  2892.                   
  2893.                   MMGRNODE.DIX - The data file's index.  This file will be MUCH
  2894.                         smaller, and contains information to quickly jump to an
  2895.                         individual system's info based on Zone, Net, and Node.
  2896.          
  2897.          Mail Manager +Plus+ will look for these two files in your Mail Manager
  2898.          directory whenever a netmail message is found within a reply packet.
  2899.          
  2900.          For those using multiple nodelists, consider which one you'll use the
  2901.          most, and compile that one FIRST, to improve on search speed.  For
  2902.          example, say you're compiling the RBBS-NET nodelist (zone 8) and the
  2903.          entire FIDO-NET nodelist.  RBBSLIST is so small that the search time
  2904.          to go through it to get to FIDO addresses is minimal.  On the other
  2905.          hand, it would take considerably longer to have to go through the
  2906.          entire FIDONET nodelist when you're looking for someone in RBBS-NET.
  2907.          You get the idea.  To compile using this scenario, here's the command
  2908.          lines you'd use (we'll just use dummy nodelist filenames for the
  2909.          moment).  Make sure you're in your Mail Manager +Plus+ directory!:
  2910.          
  2911.            MMGRNODE C:\BINKLEY\RBBSLIST.178
  2912.            MMGRNODE /A C:\BINKLEY\NODELIST.094
  2913.          
  2914.          This would create MMGRNODE.DAT and MMGRNODE.DIX from scratch, starting
  2915.          with the RBBS-NET nodelist.  The FIDO nodelist would be appended to
  2916.          it.  You can append as many nodelists as you'd like in this way.  (We
  2917.          tried five, for testing purposes, and had no trouble).
  2918.          
  2919.          At this point, you should be all setup and ready to roll with your
  2920.          FIDO areas, as well as your NETMAIL areas.
  2921.  
  2922.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 57 -
  2923.  
  2924.  
  2925.          NETMAIL MESSAGES WITHIN REPLY PACKETS
  2926.          -------------------------------------
  2927.          
  2928.          Uploaded *.REP's will work just like they always have within Mail
  2929.          Manager and Mail Manager +Plus+, until you run into a NETMAIL message.
  2930.          When Mail Manager +Plus+ encounters a message for a conference you
  2931.          have configured as netmail in your REP packet, it stops to ask you a
  2932.          few questions, so DON'T RUN MAIL MANAGER +PLUS+ FROM A SCRIPT, IF
  2933.          YOU'RE UPLOADING NETMAIL!  There *is* one exception to this rule:
  2934.          read on to find out what it is.
  2935.          
  2936.          You'll be informed that this is a *NETMAIL MESSAGE*, then will be
  2937.          asked a series of questions:
  2938.          
  2939.          Users that have sufficient security to read ALL messages (or higher)
  2940.          will get the option of posting the message as C)rash, and will also
  2941.          get the file request and attach options.  Users with security LOWER
  2942.          than this will not get these options, and their netmail will be posted
  2943.          "normally" (as an *.MSG in your netmail directory, waiting to be
  2944.          tossed out by your mail processor).  REMINDER - Mail Manager +Plus+
  2945.          can only handle outbound crashmail if you are running BinkleyTerm!
  2946.          
  2947.          If the user has sufficient security, the first question will be:
  2948.          "Send message [N]ormally, or C)rash?"
  2949.          
  2950.             (Defaults to normal).  A crash message goes directly to your
  2951.             outbound area, and is also posted (and marked as sent) in your
  2952.             netmail area.  A normal message is posted in your netmail area, and
  2953.             is not sent to anyone until your mail packer finds and moves it.
  2954.          
  2955.          If a (C)rash message, you'll be asked: "File attach Y/[N]?"
  2956.          
  2957.             (Defaults to No).  If you tell it yes, you'll be prompted for the
  2958.             path/filename to send out.
  2959.          
  2960.          If a (C)rash message, you'll also be asked: "File request Y/[N]?"
  2961.             
  2962.             (Defaults to No).  If you tell it yes, you'll be prompted for the
  2963.             name to request.
  2964.             
  2965.             NOTE - In our current state of development, you can do one or the
  2966.             other (attach or request), but not both!  If you really need to
  2967.             both attach and request to the same system at the same time, you'll
  2968.             have to upload two separate netmail messages:  1 for the request,
  2969.             and 1 for the attach.
  2970.          
  2971.          "Private Message Y/N?"
  2972.          
  2973.             Defaults to whatever it was set to in the REP packet.
  2974.          
  2975.          "Search by I)D, or S)ysop name ([ENTER] = bypass the search)?"
  2976.          
  2977.             This is where Mail Manager +Plus+ will look at the MMGRNODE.DAT and
  2978.             MMGRNODE.DIX files created by the MMGRNODE.EXE nodelist compiler.
  2979.             Here are what the 3 options mean to you:
  2980.  
  2981.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 58 -
  2982.  
  2983.  
  2984.             
  2985.             (I)D - You'll be asked for an exact Zone:Net/Node[.Point] number to
  2986.                  look up (Point is optional).  If Mail Manager +Plus+ finds a
  2987.                  hit, it will first ask you whether or not to [A]ccept what it
  2988.                  found, then either search again, or ask you whether or not to
  2989.                  post the message.  The ID search uses the data index file, and
  2990.                  is VERY fast.  Please note that if you are sending your
  2991.                  message to a POINT address, the search will pull up the HOST
  2992.                  system for that point.  This is perfectly normal.
  2993.             
  2994.             (S)ysop name - You'll be asked for a partial sysop name to look
  2995.                  for.  The search is NOT case sensitive.  As soon as Mail
  2996.                  Manager +Plus+ finds the first hit, it displays what it finds,
  2997.                  and asks you whether to accept what it found, or search again.
  2998.                  Please note that you can't search by sysop name if you are
  2999.                  sending mail to a point, unless you have compiled a separate
  3000.                  "point nodelist" with MMGRNODE.EXE.
  3001.             
  3002.             [ENTER] - Bypass the search.  You'll key in the
  3003.                  Zone:Net/Node[.Point] ID's, and *NO* error checking will be
  3004.                  performed.  Mail Manager +Plus+ will take whatever you give
  3005.                  it, and attempt to post the message.  This is the only option
  3006.                  available to you if you did not utilize the MMGRNODE.EXE
  3007.                  program.
  3008.             
  3009.             Post Message Y)es, N)o, M)odify ([ENTER] = Y)?
  3010.             
  3011.          We do give you one last chance to abort the message <grin>.  If you
  3012.          made a mistake, you can choose "M" to start over and re-enter the
  3013.          information.
  3014.          
  3015.          There is a quick and easy way to bypass all of this.  If the very
  3016.          first line of the message body contains nothing but "TO: address",
  3017.          then the door will attempt to use that address as a normal message (to
  3018.          be scanned out later by your mail processor).  For example, if the
  3019.          first line of the message body reads:
  3020.                                  TO: 1:380/14
  3021.          ...here is what will happen:
  3022.          
  3023.              - MMGRNODE.NDX is searched for Zone 1, and Net 380.
  3024.              
  3025.              - If found, MMGRNODE.DAT is searched for 1:380/14.
  3026.              
  3027.              - If found, the message will be posted normally in your netmail
  3028.                area, without requiring further intervention.
  3029.              
  3030.              If any of the above are NOT found, the "TO:" line is ignored, and
  3031.              you will be prompted as always for the full information about the
  3032.              netmail message.
  3033.          
  3034.          This works for netmail messages found within REP packets, as well as
  3035.          netmail messages that are entered online within the door.  You can
  3036.          also specify a point address on this line, if the need ever arises.
  3037.          (Example:  To: 1:380/14.1).
  3038.          
  3039.  
  3040.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 59 -
  3041.  
  3042.  
  3043.          You cannot send a CRASH message or a file attach/request in this way,
  3044.          but you might find this option handy for posting a quickie routed
  3045.          message now and then.
  3046.          
  3047.                      ---------------------------------------
  3048.          
  3049.          NOTE - We haven't forgotten about the InterNet.  The door will only
  3050.          look at the first line of the message for the "To:" directive.  Any
  3051.          FOLLOWING "To:" line will be passed through as-is.  So, to send off a
  3052.          message to the International Fido Internet gateway, destined to a
  3053.          specific Internet user, the first two lines of the message body might
  3054.          read:
  3055.          
  3056.              To: 1:1/31
  3057.              To: 72677.502@compuserve.com
  3058.          
  3059.          The first line of this netmail message directs it to 1/31 (the
  3060.          Internet gate), and the 2nd line tells the UUCP software on the
  3061.          other end that it is to be sent to "72677.502@compuserve.com".
  3062.          (That's Chip Morrow's Internet address, by the way).  The first
  3063.          "To:" line will be stripped from the message body itself when
  3064.          posted.
  3065.  
  3066.     FIDO-STYLE *.MSG MESSAGE AREAS                                  - Page 60 -
  3067.  
  3068.  
  3069.          LAST MINUTE THOUGHTS ON FIDO
  3070.          ----------------------------
  3071.          
  3072.          That's about it for the FIDO *.MSG and NETMAIL implementations.  A
  3073.          couple of things that should probably be mentioned:  Eddie Rowe has
  3074.          written a program that we have never tried, and that's NoSnail.
  3075.          NoSnail has the capability of sending netmail from an RBBS-PC message
  3076.          base (*M.DEF).  If you are using this utility, you can ignore all of
  3077.          the above for netmail areas, and use Eddie's instructions instead.
  3078.          Aren't you glad you read this far? <g>
  3079.          
  3080.          Message extracting, and manually setting last message read markers are
  3081.          noticeably slower in *.MSG conferences.  There are several reasons for
  3082.          this, most of which probably don't need a lot of explanation, but here
  3083.          are a few anyway:
  3084.          
  3085.          Each message is in a separate file.  Therefore, there's an awful lot
  3086.          of file opening and closing going on.
  3087.          
  3088.          A user might be posting (or have just posted) a FIDO message via Mail
  3089.          Manager (or some other utility) on another node of your BBS.  We
  3090.          perform checks to guard against this (and allow for it), which slows
  3091.          things down a bit.
  3092.          
  3093.          Fido messages don't have a whole lot of "standardization".  A
  3094.          perfectly valid message could have any number of different things
  3095.          determining end of printable line, or *NO* end of line markers at all.
  3096.          So, there's a lot of checking and conversion to be done in order to
  3097.          get the message into QWK format.
  3098.          
  3099.          Beyond that... it is acceptably fast on a non-networked system (even a
  3100.          fairly slow one), but the extraction process really bogs down when run
  3101.          through a network with fairly slow transfer rates.  We are working on
  3102.          a few ideas to speed up the extraction process in some future release.
  3103.  
  3104.     MISCELLANEOUS CONSIDERATIONS                                    - Page 61 -
  3105.  
  3106.  
  3107.          DEBUGGING YOUR SETUP, AND RUNNING IN LOCAL MODE
  3108.          -----------------------------------------------
  3109.          
  3110.          Assuming (again) that your Mail Manager +Plus+ directory is named
  3111.          \MAILMGR:
  3112.          
  3113.          Change to the \MAILMGR directory, and run MAILMGR.EXE with no command
  3114.          line to bring the door up in local mode.
  3115.          
  3116.          NOTE - Depending on how many conferences you've entered, Mail Manager
  3117.          +Plus+ may take a while to come up.  Mail Manager +Plus+ attempts to
  3118.          find the user in each and every conference as soon as it loads to
  3119.          determine which conferences the user has and has not joined.  The more
  3120.          conferences you have, and the slower your hard disk, the longer this
  3121.          will take.  This is required by the security measures mentioned in the
  3122.          'features' section.
  3123.          
  3124.          If this is a first-time installation, Mail Manager +Plus+ should say
  3125.          that you're a new user and walk you through the user setup.
  3126.          
  3127.          We think it is necessary to mention Mail Manager +Plus+'s own running
  3128.          scenario, since it is important for you as the SysOp to understand
  3129.          this for any debugging purposes on your end.
  3130.          
  3131.          You created   +-- Work directories created & maintained by the door.
  3132.                 |      |
  3133.             \MAILMGR   |
  3134.                        |
  3135.             \MAILMGR\LOCAL
  3136.                     \NODE1
  3137.                     \NODE2
  3138.                     ...etc.
  3139.          
  3140.          Mail Manager +Plus+ changes to these work directories as it runs, and
  3141.          changes back to the parent directory just as it exits.  If you used
  3142.          the "/W" work directory command line switch, these directories will be
  3143.          created and manipulated wherever you specified them to be.
  3144.          
  3145.          If you are not using Mail Manager's list of archivers (MAILMGR.ARL),
  3146.          one file that absolutely MUST be in the directory that you created is
  3147.          RBBSQWK.BAT.   If you are running the list of archivers, this file is
  3148.          not needed -- in fact, you can save some precious execution time by
  3149.          deleting this file completely... it will save an unneeded SHELL to
  3150.          this batch file (and consequently, perhaps a bit of SHROOM swapping).
  3151.          
  3152.          But if you are NOT running MAILMGR.ARL:  DON'T DELETE OR RENAME
  3153.          RBBSQWK.BAT!!!  You can edit RBBSQWK.BAT if you are familiar with the
  3154.          format of the CONTROL.DAT file that is included in all .QWK packets,
  3155.          and/or want to modify what the users will receive in their QWK's.
  3156.          This is not for the faint of heart, requires some knowledge of how
  3157.          things work in QWK land, and simply isn't necessary.  If it exists,
  3158.          RBBSQWK.BAT is run each time that Mail Manager +Plus+ creates a QWK
  3159.          packet for the user to download, and doesn't do anything at all if you
  3160.          are using the list of archivers, MAILMGR.ARL.
  3161.          
  3162.  
  3163.     MISCELLANEOUS CONSIDERATIONS                                    - Page 62 -
  3164.  
  3165.  
  3166.          FOR A FIRST-TIME INSTALLATION, WE RECOMMEND YOU DON'T MODIFY
  3167.          RBBSQWK.BAT!
  3168.          
  3169.          An important consideration is what to do with your own personal QWK's
  3170.          and REP's created locally.  You may find it convenient to configure
  3171.          your offline reader to use the \MAILMGR\LOCAL directory for all .REP's
  3172.          and .QWK's, since that's where Mail Manager will manipulate your mail
  3173.          in local mode.
  3174.          
  3175.          To stick a .REP packet into your message bases, just U)pload while in
  3176.          local mode, and select any protocol other than N)one.  If your .REP
  3177.          packet is in the \MAILMGR\LOCAL directory, it will be processed as if
  3178.          you'd uploaded the file remotely.
  3179.          
  3180.          It is important to make you aware that there is a sysop-only menu
  3181.          option available, and that's "I" (Info), which isn't listed in either
  3182.          the command prompt, or the menu itself.  This menu option is available
  3183.          only to those with sufficient security to read ALL messages, or
  3184.          greater.  If the user does not have at least this security level, they
  3185.          will see the familiar "Command not recognized", instead.
  3186.          
  3187.          If you have set yourself up with sufficient security to use this
  3188.          option, pressing "I" at the Mail Manager +Plus+ main menu will greet
  3189.          you with something like this:
  3190.          
  3191.                SYSOP INFORMATION:
  3192.          
  3193.                Mail Manager version ............: v3.51
  3194.                Mail Manager path ...............: C:\MAILMGR
  3195.                MailMGR's operating environment .: LANtastic v4.10 (NetBIOS)
  3196.                DOS version .....................: 6.00
  3197.                DOS SHARE detected? .............: Yes
  3198.                Flow control method .............: Local mode
  3199.                Free string space ...............: 20624
  3200.                Non-string array avail ..........: 273408
  3201.                Available stack space ...........: 1738
  3202.                MAIN message base ...............: E:\RBBS\MAINM.DEF
  3203.                MAIN users file .................: E:\RBBS\MAINU.DEF
  3204.                Highest message # in MAIN .......: 6132
  3205.                Last msg # YOU read in MAIN .....: 6131
  3206.                Filename of protocol definitions : C:\MAILMGR\MAILMGR.PRO
  3207.                Filename of list of archivers ...: C:\MAILMGR\MAILMGR.ARL
  3208.                Filename of FMS directory .......: E:\RBBS\MASTER.DIR
  3209.                RBBS-PC semaphore file ..........: E:\RBBS\IBMFLAGS
  3210.                MailMGR semaphore file ..........: MMFLAGS
  3211.                RBBS-PC semaphore file size (6) .: 6
  3212.                MailMGR semaphore size (3) .: 3
  3213.          
  3214.             These 20 are all of the possible lines that can be shown to you.
  3215.             The last four will be displayed only if your environment is
  3216.             NetBIOS.
  3217.          
  3218.  
  3219.     MISCELLANEOUS CONSIDERATIONS                                    - Page 63 -
  3220.  
  3221.  
  3222.             Some of the more important information in here:
  3223.          
  3224.                Mail Manager path should reflect the drive and directory that
  3225.                you have installed the program in.  If it doesn't, your batch
  3226.                file is probably not changing to the proper directory prior to
  3227.                running MAILMGR.EXE.
  3228.                
  3229.                Mail Manager's operating environment should reflect what you've
  3230.                told Mail Manager to use.  If it doesn't, there's definitely a
  3231.                problem!
  3232.                
  3233.                DOS version must be 3.30 or above in order for Mail Manager
  3234.                +Plus+ to operate properly.
  3235.                
  3236.                DOS SHARE must be detected if you are operating in a NetBIOS
  3237.                environment.  The only exception is if you are running under a
  3238.                NOVELL network, in which case SHARE checking is bypassed.
  3239.                
  3240.                Flow control method can report one of five things:  Local mode,
  3241.                FOSSIL, RTS/CTS, XON/XOFF, or NONE.
  3242.                
  3243.                Free string space is pretty darned important, too.  This should
  3244.                really be up around 10,000 or higher at all times when you
  3245.                display this screen.  If it is less than that, we want to hear
  3246.                about it!
  3247.                
  3248.                Non-string array available is approximately the amount of free
  3249.                memory that is available for DSZ and your file compression/
  3250.                extraction programs.  If this number is less than 200K, you are
  3251.                likely to run into trouble, and should check to make sure that
  3252.                you are EXITING, (NOT SHELLING!) from RBBS-PC to Mail Manager
  3253.                +Plus+.  The only other way that we can think of that would
  3254.                cause you to have less than 200K available on today's 640K+ PC's
  3255.                would be if you have a VERY large # of conferences.  If you have
  3256.                less than 200K here, you will probably need a utility like
  3257.                SHROOM (mentioned in the memory requirements section of this
  3258.                document) in order to use Mail Manager +Plus+.
  3259.                
  3260.                MAIN message base and user file names must match what is true
  3261.                for your MAIN area.  If not, you don't have MAIN as your 1st
  3262.                conference listed, and Mail Manager +Plus+ will NOT operate
  3263.                properly.
  3264.                
  3265.                Highest message number in MAIN, and highest message # that you
  3266.                read in main should be accurate.  If they're not, then Mail
  3267.                Manager +Plus+ didn't properly find you in the MAIN users file,
  3268.                and/or it wasn't able to correctly access the MAIN message file.
  3269.                
  3270.                Filename of list of protocol definitions should match what you
  3271.                told MAILCFG to use for MAILMGR.PRO.
  3272.                
  3273.                Filename of list of archivers should match what you told MAILCFG
  3274.                to use.  (If this file does not exist, Mail Manager will use the
  3275.                default type of compression that you chose, and will require
  3276.                said archiver to be in a DOS path!)
  3277.  
  3278.     MISCELLANEOUS CONSIDERATIONS                                    - Page 64 -
  3279.  
  3280.  
  3281.                
  3282.                Filename of FMS directory should match what is true for your
  3283.                system if you are using an RBBS-PC FMS directory, or "NONE"
  3284.                otherwise.
  3285.                
  3286.                The last four lines will only be shown to you if you are running
  3287.                under NetBIOS, and they are described in better detail elsewhere
  3288.                in this manual.
  3289.                
  3290.                If, after following these instructions, you continue to have
  3291.                trouble, take a look at the "COMMON PROBLEMS" section of this
  3292.                manual.
  3293.  
  3294.     MISCELLANEOUS CONSIDERATIONS                                    - Page 65 -
  3295.  
  3296.  
  3297.          HANDLING NON-STD PORTS VIA MAILMGR.PRO
  3298.          --------------------------------------
  3299.          
  3300.          The easiest way to handle nonstandard port addresses in Mail Manager
  3301.          +Plus+ is to create a separate configuration file for each node, and
  3302.          have each configuration file point to a different copy of MAILMGR.PRO.
  3303.          The downside of doing this is that every change you later make in your
  3304.          configuration will have to be duplicated for each node's configuration
  3305.          file.   It IS possible to achieve the same results with a single
  3306.          configuration file, however.
  3307.          
  3308.          In order to support a nonstandard port address in a single
  3309.          configuration file, have your MAILMGR.PRO specify a custom batch file,
  3310.          rather than a direct call to the protocol executable itself.  Your
  3311.          custom batch file can then send the correct commands to the protocol,
  3312.          depending on which port is involved.
  3313.          
  3314.          Here's what an entry in the MAILMGR.PRO file might look like.  (This
  3315.          should all be on one line, of course, but is split here for clarity):
  3316.          
  3317.                 "Z)modem (Batch)",0,S,8,,B,1024,,0.95,,1=E,
  3318.                 "X:\ZMODEM.BAT S [PORT#] [BAUD] [FILE]",
  3319.                 "X:\ZMODEM.BAT R [PORT#] [BAUD] [FILE]"
  3320.          
  3321.          With drive X: of course being whatever drive\directory you want.
  3322.          
  3323.          Then the ZMODEM.BAT file could look something like (assuming that you
  3324.          have ports 1 and 2 at standard addresses, and port 3 at non-standard
  3325.          address 3e8, irq 5):
  3326.          
  3327.                    @ECHO OFF
  3328.                    : --------------------------------------
  3329.                    : 1st arg is either S or R,
  3330.                    : 2rd arg is comm port number
  3331.                    : 3rd arg is bps rate, and
  3332.                    : 4th arg is filename being transferred.
  3333.                    : --------------------------------------
  3334.                    IF (%1)==(S) GOTO SEND
  3335.                    IF (%1)==(R) GOTO RECEIVE
  3336.                    GOTO END
  3337.                    
  3338.                    :SEND
  3339.                      IF NOT (%2)==(3) dsz port %2 speed %3 sz -m %4
  3340.                      IF     (%2)==(3) dsz portx 3e8,5 speed %3 -m sz %4
  3341.                      GOTO END
  3342.                    
  3343.                    :RECEIVE
  3344.                      IF NOT (%2)==(3) dsz port %2 speed %3 rz %4
  3345.                      IF     (%2)==(3) dsz portx 3e8,5 speed %3 rz %4
  3346.                    
  3347.                    :END
  3348.          
  3349.  
  3350.     MISCELLANEOUS CONSIDERATIONS                                    - Page 66 -
  3351.  
  3352.  
  3353.          This could, of course, be refined into a single batch file that
  3354.          handles all protocols, not just Zmodem, but it should serve to
  3355.          illustrate the principle.  Or a separate batch file could be set up
  3356.          for each protocol.
  3357.          
  3358.          We leave it to you to adapt for protocol drivers other than DSZ.
  3359.  
  3360.     MISCELLANEOUS CONSIDERATIONS                                    - Page 67 -
  3361.  
  3362.  
  3363.          DESQVIEW, OS/2, NETWORKS, AND MULTIPLE NODES
  3364.          --------------------------------------------
  3365.          
  3366.          Operating in a multitasking environment or on a network is a special
  3367.          case, worthy of further explanation!
  3368.          
  3369.          First off, Mail Manager +Plus+ can automatically detect the following
  3370.          conditions:
  3371.          
  3372.                - Is Mail Manager running in an OS/2 Dos box?
  3373.                - Is SHARE installed under DOS?
  3374.                - Is DESQview present?
  3375.                - Is Artisoft's LANtastic present?
  3376.                - Is Novell present?
  3377.          
  3378.          What Mail Manager +Plus+ detects will be used as the basis for
  3379.          initially determining the operating environment, which will be:
  3380.          
  3381.            - DESQview, if it is present.
  3382.            
  3383.            - NetBIOS, if DESQview is not present, and SHARE is installed, or
  3384.              OS/2 or Novell is detected.
  3385.            
  3386.            - Good ole' normal DOS if neither of the above is true.
  3387.          
  3388.          Mail Manager +Plus+ will initially use the above file locking
  3389.          technique for the type of environment that was detected.  At this
  3390.          point, the only file being accessed is Mail Manager's own
  3391.          configuration file, so your RBBS files are quite safe even if this is
  3392.          not the same environment that you have specified for RBBS to use.
  3393.          
  3394.          Once the program has progressed far enough to have read what network
  3395.          type you specified (i.e. your RBBS network setting from DORINFOx.DEF
  3396.          if operating remotely, or MAILMGR.CFG if operating in local mode),
  3397.          Mail Manager +Plus+ will, if necessary, switch to your specified type
  3398.          of network.
  3399.          
  3400.          With that out of the way, let's talk about the supported environment
  3401.          types, and what they mean from the standpoint of Mail Manager +Plus+:
  3402.          
  3403.            DESQview - Mail Manager +Plus+ will use the same file and record
  3404.               locking scheme that RBBS-PC itself uses.  In fact, it uses the
  3405.               very same assembler source, which was written by Jon Martin in
  3406.               1988.  Therefore, the DESQview semaphore locking routines used by
  3407.               Mail Manager +Plus+ are copyrighted by Jon Martin, and are
  3408.               available to anyone who has a copy of RBBS-PC's source code.
  3409.               Look for RBBSDV.ASM in RBBS-PC's assembler source.  Mail Manager
  3410.               +Plus+ also gives back unused time slices under DESQView,
  3411.               resulting in a speedup of your other nodes.
  3412.            
  3413.  
  3414.     MISCELLANEOUS CONSIDERATIONS                                    - Page 68 -
  3415.  
  3416.  
  3417.            NetBIOS - This is a special case, and requires that physical file
  3418.               and record locking take place (this is also what is used under
  3419.               Novell).  RBBS-PC uses what is termed as a "semaphore" file, to
  3420.               control access to what Mail Manager +Plus+ is concerned with:
  3421.               Your USERS file(s), your MESSAGES file(s), and your FMS file (if
  3422.               any).
  3423.               
  3424.               This is done with the hard-coded filename "IBMFLAGS", which will
  3425.               exist in the same directory as your MAIN message base.  If you're
  3426.               already running RBBS-PC under NetBIOS, look for it... it should
  3427.               already be there.  IBMFLAGS is 6 bytes in length, and contains
  3428.               nothing but three empty 2-byte records, which are controlled by
  3429.               RBBS-PC and Mail Manager +Plus+ to limit access to USERS,
  3430.               MESSAGES, and FMS directory files.
  3431.               
  3432.               Under NetBIOS, in addition to IBMFLAGS, Mail Manager +Plus+ will
  3433.               create and maintain its own "semaphore" locking file to control
  3434.               access to its own files, using the same principle as IBMFLAGS.
  3435.               The Mail Manager +Plus+ semaphore file is named MMFLAGS, and will
  3436.               be created in your Mail Manager +Plus+ directory.  MMFLAGS will
  3437.               be 3 bytes in length, and manipulated by all nodes of Mail
  3438.               Manager +Plus+.
  3439.               
  3440.               It is also noteworthy that all files will be opened in SHARED
  3441.               mode, which is the nature of the NetBIOS beast.
  3442.               
  3443.               If you are running under Novell Netware, Mail Manager +Plus+ will
  3444.               detect it, and will not check for the installation of DOS SHARE.
  3445.               If Novell is not detected, yet NetBIOS is specified as the
  3446.               environment, Mail Manager will check for DOS SHARE before
  3447.               allowing itself to continue.
  3448.               
  3449.            
  3450.            OS/2 - Unless DESQView is specified in your setup, and then
  3451.               detected, Mail Manager +Plus+ will operate in NetBios mode (see
  3452.               above) when OS/2 is detected.  Mail Manager +Plus+ gives back
  3453.               unused time slices under OS/2, thus speeding up your system
  3454.               (there is no need to use OS2SPEED or similar utilities to "fool"
  3455.               Mail Manager into giving back DESQView time slices).
  3456.            
  3457.            DOS  - Gee, isn't it nice when you don't have to worry about all
  3458.               this?  Under good 'ole DOS, none of the above is meaningful, and
  3459.               all files will be opened normally, with no sharing or locking
  3460.               mechanisms in place.
  3461.          
  3462.          If you happen to be running in an environment that does NOT match any
  3463.          of the above situations, AND you are sharing the same set of RBBS
  3464.          message bases and users files between nodes, you will want to consider
  3465.          having DOS SHARE loaded, and configuring both RBBS-PC and Mail Manager
  3466.          +Plus+ to use NetBIOS as the operating environment.
  3467.          
  3468.          Or, if file sharing is not a concern, just configure Mail Manager
  3469.          +Plus+ to use DOS as its environment.
  3470.          
  3471.  
  3472.     MISCELLANEOUS CONSIDERATIONS                                    - Page 69 -
  3473.  
  3474.  
  3475.          For most installations, you can run up to 36 nodes from a single
  3476.          configuration file, utilizing a unique work directory for each node.
  3477.          Unusual installations (non-standard comm ports have already been
  3478.          discussed) can be accommodated via separate configuration files for
  3479.          one or more nodes.  One such case might be a networked setup in which
  3480.          the network drive letters are not the same for each node (C:\MAINM.DEF
  3481.          on one, D:\MAINM.DEF on another).  Why you'd set your network up that
  3482.          way we don't know, but it isn't our place to, is it?
  3483.  
  3484.     MISCELLANEOUS CONSIDERATIONS                                    - Page 70 -
  3485.  
  3486.  
  3487.          WORKING WITH A FOSSIL DRIVER
  3488.          ----------------------------
  3489.          
  3490.          Mail Manager +Plus+ does support a FOSSIL driver.  If you told RBBS-PC
  3491.          to use a FOSSIL, Mail Manager +Plus+ will also.  The door has been
  3492.          tested extensively with both BNU v1.70 and X00 v1.2x FOSSILs.
  3493.          
  3494.          PLEASE NOTE that some door converters & programs that 'launch' doors
  3495.          for you may not correctly set the FOSSIL argument in DORINFOx.DEF!!!!
  3496.          
  3497.          The very last line of your DORINFOx.DEF (line #13) should be either a
  3498.          zero or minus one (0 or -1).  -1 indicates that the FOSSIL is active
  3499.          in RBBS-PC, and tells the door that it too should use a FOSSIL.
  3500.          
  3501.          To keep you from having to dig up the RBBS-PC documentation, here's
  3502.          what Mail Manager +Plus+ expects from DORINFOx.DEF:
  3503.          
  3504.              NEWARK CONNECTION  <- BBS name (ignored by Mail Manager +Plus+)
  3505.              CHIP               <- Sysop's first name
  3506.              MORROW             <- Sysop's last name
  3507.              COM1               <- Communications port
  3508.              2400 BAUDD,N,8,1   <- Communications parameters
  3509.               6                 <- Network type (4=DV, 6=NetBIOS)
  3510.              JOE                <- User's first name
  3511.              USERNAME           <- User's last name
  3512.              NEWARK, OH         <- User's city/state
  3513.              2                  <- User's graphics preference (2=ANSI)
  3514.              10                 <- User's security level
  3515.              30                 <- Number of minutes remaining
  3516.              -1                 <- FOSSIL in use (0=no, -1=yes)
  3517.              
  3518.              * NOTE - The second "D" in "BAUDD" is a bug in RBBS-PC 17.3C, and
  3519.              may or may not be present in your own DORINFOx.DEF files.  Either
  3520.              way, it does not affect the operation of the door.
  3521.              
  3522.          It is possible to configure Mail Manager to ALWAYS check for a FOSSIL
  3523.          driver, regardless of the setting in DORINFOx.DEF.  This is done in
  3524.          the MAILCFG program, by setting the flow control method to "F".  In
  3525.          this case, Mail Manager +Plus+ will ALWAYS try to use a FOSSIL for
  3526.          communications.
  3527.  
  3528.     MISCELLANEOUS CONSIDERATIONS                                    - Page 71 -
  3529.  
  3530.  
  3531.          QWK NETWORKING
  3532.          --------------
  3533.          
  3534.          In addition to handling mail for individual callers, Mail Manager
  3535.          +Plus+ can also process QWK-formatted network mail packets for sharing
  3536.          conferences between bulletin boards.
  3537.          
  3538.          When used as the net host, Mail Manager +Plus+ can create the "net
  3539.          status" packets needed to interface with existing QWK-based network
  3540.          software such as TNET and RNET in use by node boards.
  3541.          
  3542.          For node operation, we provide a utility called MNET which converts a
  3543.          "net status" QWK packet from a host into a REP which can then be
  3544.          uploaded into the node BBS's QWK door.  MNET also does the reverse
  3545.          conversion, taking messages exported from the node system via a QWK
  3546.          and converting them to a REP that can then be uploaded to the host
  3547.          system.  This eliminates the need for a separate network interface
  3548.          such as RNET.  Although MNET is ideal for use with a Mail Manager
  3549.          +Plus+ system (and MMGR+ has several enhancements that allow them to
  3550.          work well together) MNET may be used with any system capable of
  3551.          exporting QWK packets and receiving REP packets.
  3552.          
  3553.          Since this subject is a fairly complex one, details are handled in a
  3554.          separate file called NETINFO.DOC.
  3555.          
  3556.          
  3557.          COMPRESSING THE EXECUTABLE FILES
  3558.          --------------------------------
  3559.          We're distributing the executables in non-compressed format.  You'll
  3560.          find that our .EXE's will compress quite nicely with utilities like
  3561.          PKLITE and LZEXE.  We leave it up to you to use the compression
  3562.          utility of your choice, or run as-is.
  3563.          
  3564.  
  3565.     MISCELLANEOUS CONSIDERATIONS                                    - Page 72 -
  3566.  
  3567.  
  3568.          SECURITY FEATURES
  3569.          -----------------
  3570.          
  3571.          Mail Manager +Plus+ has extensive built-in security functions.  We
  3572.          hope you agree that it does make for a pretty secure mail door.
  3573.          
  3574.          We want to make you aware of the importance of the security level that
  3575.          you configured in the MAILCFG program for the ability to read ALL
  3576.          messages.  This security level is checked for all of the SysOp
  3577.          functions that Mail Manager +Plus+ performs, and should be set to
  3578.          either SysOp or Co-SysOp level only!  Some of the more important
  3579.          things that users with this security level or higher can do:
  3580.          
  3581.          - Use the SysOp-only function I)nfo from the main menu (which shows
  3582.            where everything that pertains to your Mail Manager +Plus+ setup is
  3583.            located).
  3584.            
  3585.          - Upload a message under a name other than the one that they use on
  3586.            the BBS, regardless of the setting of the "Alias file" argument in
  3587.            the MAILCFG program for that conference.
  3588.            
  3589.          - Read everybody's mail, regardless of whether it's marked as private
  3590.            or password-protected.
  3591.            
  3592.          - Use the C)rash option when uploading netmail messages, and also the
  3593.            file attach and request options.
  3594.            
  3595.          You get the idea.
  3596.          
  3597.          Contrary to some of the concerns we have received on this subject over
  3598.          the last few years, a user CANNOT inadvertently download a mail packet
  3599.          that was extracted by a previous user of the door.  Mail Manager
  3600.          +Plus+ temporarily keeps the mail packet on disk so that the SysOp can
  3601.          check it out for appearance, if there were any problems in the
  3602.          transfer, etc.  Mail Manager +Plus+ deletes any existing mail packet
  3603.          whenever a user attempts to D)ownload, E)xpedite, or U)pload.
  3604.          
  3605.          Conferences are configured with two minimum security levels:  One for
  3606.          the ability to read, and the other for the ability to post.
  3607.          
  3608.          Users can only extract mail from conferences that they have joined
  3609.          (either from the BBS itself, or via Mail Manager +Plus+, if you have
  3610.          turned "on" this ability in the MAILCFG program).
  3611.          
  3612.          Mail Manager +Plus+ will add a user to a conference only if you have
  3613.          specified that it is OK to do so in the MAILCFG program.
  3614.          
  3615.          Mail Manager +Plus+ bypasses all killed messages.
  3616.          
  3617.          Password-protected messages are only extracted and downloaded to users
  3618.          with an exact name match in the "TO" or "FROM" fields, or to those
  3619.          with sufficient security to read ALL messages.
  3620.          
  3621.  
  3622.     MISCELLANEOUS CONSIDERATIONS                                    - Page 73 -
  3623.  
  3624.  
  3625.          With two exceptions, only users with sufficient security to read ALL
  3626.          messages are permitted to upload messages under a name other than the
  3627.          one they use on the BBS.  The exceptions are:
  3628.          
  3629.          - If you have configured Mail Manager +Plus+ to look for an ALIAS file
  3630.            for a given conference, it will accept messages from the user's pre-
  3631.            defined alias, and will change the user's real name to his alias
  3632.            before posting.
  3633.            
  3634.          - If you have configured a specific username for "net status" QWK
  3635.            network capability, that username will be able to upload messages
  3636.            with any name in the "FROM" field.
  3637.            
  3638.          
  3639.          Users cannot upload messages to conferences that they have not joined.
  3640.          
  3641.          Mail Manager +Plus+ posts a private message to the sender's true name
  3642.          whenever a security violation regarding an uploaded reply occurs.
  3643.          This by default will be placed in Conference #1, but the sysop can
  3644.          designate a different conference to receive violation notices via the
  3645.          /V command line option when loading the door.  Violation notices can
  3646.          be triggered by:
  3647.          
  3648.          - Uploading a message with the "FROM" name not matching the user's
  3649.            name on the BBS or his pre-defined alias.
  3650.            
  3651.          - Uploading a message to a conference that the user has not joined.
  3652.            
  3653.          - Uploading a message to a conference that the user does not have
  3654.            sufficient security to post a message in.
  3655.            
  3656.          - Uploading a message to a conference number that does not exist.
  3657.            
  3658.          Files listed in your FMS directory that were uploaded as "SYSOP-ONLY"
  3659.          will be listed only in the SysOp's own mail packets.  They will be
  3660.          bypassed for everyone else.
  3661.  
  3662.     MISCELLANEOUS CONSIDERATIONS                                    - Page 74 -
  3663.  
  3664.  
  3665.          ADDITIONAL FEATURES
  3666.          -------------------
  3667.          
  3668.          CHAT MODE:  While Mail Manager +Plus+ is waiting for a keystroke
  3669.                      (preferably at the MAIN MENU), the Sysop can press [F10]
  3670.                      to jump into a no-frills chat mode with the user that's
  3671.                      currently online.
  3672.                      
  3673.                      Sysop terminates the chat by pressing [Esc] or [F10].
  3674.                      (Typing "/QUIT" by either party is no longer supported.)
  3675.          ----------------------------------------------------------------------
  3676.          DOS SHELL:  While Mail Manager +Plus+ is waiting for a keystroke
  3677.                      (again, preferably at the MAIN MENU), the Sysop can press
  3678.                      [F2] to jump to DOS.  When finished, type EXIT to return
  3679.                      to Mail Manager +Plus+.  Naturally, this works only from
  3680.                      the local keyboard.  Mail Manager +Plus+ will
  3681.                      automatically return to the proper drive and directory, no
  3682.                      matter where you are when you type "exit" to return from
  3683.                      the DOS shell.
  3684.          ----------------------------------------------------------------------
  3685.          TIME LIMIT: This is passed to Mail Manager +Plus+ from RBBS-PC in
  3686.                      DORINFOx.DEF.  It will be either the amount of time
  3687.                      remaining on your RBBS-PC, or whatever time limit that you
  3688.                      specified in DOORS.DEF, otherwise.  In local mode, the
  3689.                      time limit is always 120 minutes.
  3690.          ----------------------------------------------------------------------
  3691.          KYBD IDLE:  If Mail Manager +Plus+ has to wait more than 180 seconds
  3692.                      for the user to press a key, it will exit back to the BBS.
  3693.                      The user will get a beep and a warning message after 90
  3694.                      seconds, and every 30 seconds thereafter, until keyboard
  3695.                      time expires.
  3696.          ----------------------------------------------------------------------
  3697.          CARRIER DETECT:  If the user drops carrier, Mail Manager +Plus+ will
  3698.                      report to you as such, write this info to the appropriate
  3699.                      log file, and return to the BBS.  RBBS-PC will see that no
  3700.                      carrier detect is present, re-cycle itself, and wait for
  3701.                      the next caller.
  3702.          ----------------------------------------------------------------------
  3703.          DOWNLOAD & EXIT:  Although the E)xpedite! option is documented
  3704.                      elsewhere in this manual, we didn't make it clear as to
  3705.                      the best way to automate this from RBBS-PC's standpoint.
  3706.                      
  3707.                      RBBS-PC 17.3C and above allow you to specify "/G" after
  3708.                      the name of the door, which allows the user to be logged
  3709.                      off immediately after returning to RBBS-PC.  Therefore,
  3710.                      the user could type:  "d mailmgr /g".
  3711.                      
  3712.                      Then, from within Mail Manager +Plus+, select E)xpedite!,
  3713.                      and the user will be logged completely off the BBS after
  3714.                      downloading their mail.
  3715.                      
  3716.                      As an alternative, you can choose to have the door drop
  3717.                      DTR whenever G)oodbye and E)xpedite! are chosen.  Please
  3718.                      read the warning message about this option elsewhere in
  3719.                      this documentation!
  3720.  
  3721.     MISCELLANEOUS CONSIDERATIONS                                    - Page 75 -
  3722.  
  3723.  
  3724.          ----------------------------------------------------------------------
  3725.          NEW FILES:  If you are running a standard RBBS-PC FMS directory, you
  3726.                      should be able to use this built-in capability.  If you
  3727.                      are not running a standard FMS, and the path/name of your
  3728.                      FMS directory is set to "NONE" in the MAILCFG program,
  3729.                      Mail Manager +Plus+ will not attempt to include a new file
  3730.                      listing in the user's mail packets.
  3731.                      
  3732.                      It should be noted here that the users do have the ability
  3733.                      to turn this feature "off", if they do not desire a file
  3734.                      listing in their mail packets.
  3735.                      
  3736.                      Here's what is required of your FMS directory:
  3737.                      
  3738.                      - No 'special' lines contained within it (semi-private
  3739.                      filenames preceded with an asterisk (*) before the
  3740.                      filename, special comment lines, etc).
  3741.                      
  3742.                      - Oldest files listed at the top of the FMS, and most
  3743.                      recent files listed at the bottom.
  3744.                      
  3745.                      If yours fits all of the above, NEWFILES should work fine.
  3746.                      
  3747.                      Here's the way NEWFILES works:
  3748.                      
  3749.                      1) Finds the date that the user last checked the file
  3750.                         listing (from the RBBS-PC main users file).  If user
  3751.                         never listed your file directories, the user's last
  3752.                         date into the Mail Manager +Plus+ door is used,
  3753.                         instead.
  3754.                         
  3755.                      2) Grabs the very first line of your FMS, to determine the
  3756.                         line length, since this can vary depending on how you
  3757.                         set things up via RBBS-PC's CONFIG.  HOWEVER, all lines
  3758.                         in your FMS are expected to be the same length as the
  3759.                         first line listed!
  3760.                         
  3761.                      3) After determining line length, moves to end of file,
  3762.                         grabs the very last line of your FMS, and checks the
  3763.                         date stamp against the user's "last check" date.
  3764.                         
  3765.                      4) If the last file's date is the same as, or newer than,
  3766.                         the user's date that they last listed your files,
  3767.                         NEWFILES steps through your FMS in reverse order,
  3768.                         pulling out filenames & extended descriptions until the
  3769.                         date stamp is earlier than the user's last check.  The
  3770.                         file created (NEWFILES.DAT) is then included in the
  3771.                         user's QWK mail packet, and can be viewed easily with
  3772.                         the user's mail reader.
  3773.                         
  3774.                         If the last file's date is older than the user's last
  3775.                         check, NEWFILES figures no new files, and doesn't
  3776.                         include a NEWFILES.DAT in the QWK packet.
  3777.                         
  3778.  
  3779.     MISCELLANEOUS CONSIDERATIONS                                    - Page 76 -
  3780.  
  3781.  
  3782.                      PRIVATE UPLOADS TO THE SYSOP are listed ONLY in the
  3783.                      sysop's own mail packets.  These files (and their extended
  3784.                      descriptions) are skipped for everyone else.
  3785.                      
  3786.                      If you use chained FMS directories, or any of the "\FMS"
  3787.                      directives, NEWFILES will stop searching when it reaches
  3788.                      that line of your FMS.  Why?  The line won't be an
  3789.                      extended description  ("  ." as the last three characters
  3790.                      on the line), and won't have a file date in the proper
  3791.                      positions on the line.  In this case, NEWFILES will
  3792.                      consider the file date to be 00-00-00, and will quit
  3793.                      searching your FMS directory.
  3794.                      
  3795.                      *NEW* in v3.5: If the user has ANSI turned on, the
  3796.                      NEWFILES.DAT will be in ANSI color.  This feature was
  3797.                      requested often!
  3798.  
  3799.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 77 -
  3800.  
  3801.  
  3802.          We supply several utility programs to aid in your setup and operation
  3803.          of Mail Manager +Plus+.  A quick overview:
  3804.          
  3805.          
  3806.          MailCFG, the configuration program:
  3807.          
  3808.             We recommend using MAILCFG to configure Mail Manager +Plus+.
  3809.             MAILCFG directly edits the binary configuration file, and is easy
  3810.             to use.  MAILCFG is covered in the separate section of this manual
  3811.             entitled:  "CONFIGURING MAIL MANAGER +PLUS+".
  3812.             
  3813.          CFG2TXT & TXT2CFG - the binary<-->text utilities:
  3814.          
  3815.             Throughout Mail Manager's relatively short life, we have heard from
  3816.             several SysOps who simply do not care for the configuration program
  3817.             MailCFG.  These two utilities are provided as an alternative, and
  3818.             also to ease the installation of FIDO *.MSG message areas.
  3819.             
  3820.          MAILFIX, the purge/repair/renumber utility for RBBS message files:
  3821.          
  3822.             A handy utility intended as an alternative (or replacement) for
  3823.             RBBS CONFIG's "repair" facility, MU-EDIT, and similar utilities.
  3824.             MAILFIX has the ability to keep a physical number of messages in a
  3825.             given message base (handy for echo areas), purge killed messages,
  3826.             and repair damaged messages.  MAILFIX can also renumber message
  3827.             bases and reset user message pointers according to the new message
  3828.             numbers.
  3829.             
  3830.          MMINDEX, the indexing program for *.MSG areas:
  3831.          
  3832.             Optional (but HIGHLY RECOMMENDED!) utility for SysOps running Fido
  3833.             *.MSG message areas.  This program has no meaning if you are
  3834.             running only RBBS-PC *M.DEF message bases.
  3835.             
  3836.          MMGRNODE, the nodelist compiler:
  3837.          
  3838.             Optional (but HIGHLY RECOMMENDED!) utility to compile raw nodelists
  3839.             into a shortened binary format readable by Mail Manager +Plus+.
  3840.             Useful only if you are running an *.MSG netmail area or two.
  3841.             
  3842.          MNET, the QWK network conversion utility:
  3843.          
  3844.             This utility is used only on the "node" end of a QWK network, and
  3845.             can be used with ANY BBS type that has a QWK mail door capable of
  3846.             handling MarkMail-compatible network mail packets.
  3847.             
  3848.          MUSER, the Mail Manager +Plus+ user file editor:
  3849.          
  3850.             A utility to edit/purge/manipulate Mail Manager's internal users
  3851.             file, MAILMGR.USR.  This utility was created to handle QWK network
  3852.             usernames, but has other obvious uses as well.
  3853.             
  3854.          The following pages describe these programs in greater detail.
  3855.  
  3856.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 78 -
  3857.  
  3858.  
  3859.          CFG2TXT & TXT2CFG
  3860.          -----------------
  3861.          
  3862.          Mail Manager +Plus+ uses a binary configuration file, which can be
  3863.          directly edited by the configuration program, MAILCFG.EXE.  However,
  3864.          there are some situations where MAILCFG becomes repetitive, and there
  3865.          are many SysOps who have expressed the desire for a text
  3866.          configuration.
  3867.          
  3868.          So... to address the above, these two utilities are provided.
  3869.          
  3870.          The two programs are companions:  CFG2TXT converts the standard
  3871.          MAILMGR.CFG binary configuration file into text format, and TXT2CFG
  3872.          converts a text file to Mail Manager +Plus+ binary configuration
  3873.          format.
  3874.          
  3875.          Usage of these programs:
  3876.          
  3877.            CFG2TXT [INPUT.FIL] [OUTPUT.FIL]
  3878.          
  3879.                Where INPUT.FIL is the name of the Mail Manager +Plus+ binary
  3880.                configuration file to convert, and
  3881.                
  3882.                OUTPUT.FIL is the name of the text file to create.
  3883.                
  3884.                If nothing is passed on the command line, CFG2TXT will default
  3885.                to:
  3886.                
  3887.                           INPUT.FIL  = MAILMGR.CFG
  3888.                           OUTPUT.FIL = MAILMGR.TXT
  3889.                
  3890.            TXT2CFG [INPUT.FIL] [OUTPUT.FIL]
  3891.          
  3892.                The reverse of the above.  INPUT.FIL is the name of the text
  3893.                file to convert, and OUTPUT.FIL is the name of the binary
  3894.                configuration file to create.  If nothing is passed on the
  3895.                command line, TXT2CFG will default to:
  3896.                
  3897.                           INPUT.FIL  = MAILMGR.TXT
  3898.                           OUTPUT.FIL = MAILMGR.CFG
  3899.                
  3900.                Each line in the text configuration file must be flush left.
  3901.                The supplied MAILMGR.TXT file should be pretty self-explanatory,
  3902.                but here is the run-down:
  3903.                
  3904.                Lines beginning with a semi-colon ";" are ignored as comments.
  3905.                ANY BLANK LINES WILL BE CONSIDERED PART OF THE CONFIGURATION!
  3906.                Lines without semicolons (the order in which TXT2CFG will read
  3907.                them) are as follows:
  3908.                         MAX = Maximum number of characters,
  3909.                         INT = Integer (cannot exceed 32767)
  3910.                         
  3911.  
  3912.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 79 -
  3913.  
  3914.  
  3915.                Line #  Meaning                                           MAX
  3916.                ------  ------------------------------------------------  ---
  3917.                 1      Name of your RBBS-PC.                              35
  3918.                 2      Name you use to log onto your BBS remotely.        31
  3919.                 3      Your first name as you are known to your users.    15
  3920.                 4      Your last name as you are known to your users.     15
  3921.                 5      Security level to read *ALL* messages everywhere  INT
  3922.                 6      Security level to use when operating locally.     INT
  3923.                 7      Graphics to use locally (0=no, 1=ascii, 2=ansi)     1
  3924.                 8      Default tagline to use for ALL conferences.        61
  3925.                 9      First eight characters for packet filenames.        8
  3926.                10      Default file compression (ARC,ARJ,LZH,ZIP only)     3
  3927.                11      Path/Name of news file - *NON-GRAPHIC* version.    40
  3928.                12      Path/Name of list of system bulletins.             40
  3929.                13      Type of network to use in local mode. (D,N,Q)       1
  3930.                14      Type of handshaking to use remotely (F,R,X,N)       1
  3931.                15      Path/filename of your FMS directory (optional)     40
  3932.                16      Path/filename of your list of available archivers  40
  3933.                17      Environment variable pointing to XFER-x.DEF        15
  3934.                18      Modify REP time stamp to system date/time? (Y,N)    1
  3935.                19      City/State where your BBS is located.              31
  3936.                20      Your BBS phone number.                             12
  3937.                21      Character to use for smart text (default=123)       3
  3938.                22      Default path to *M.DEF conferences.                40
  3939.                23      Path/filename of echo toss log.                    40
  3940.                24      Start of timelock.  Use 24-hour clock (HH:MM)       5
  3941.                25      End of timelock.    Use 24-hour clock (HH:MM)       5
  3942.                26      Allow door to drop DTR at G)oodbye, E)xpedite!      1
  3943.                27      Show empty/unjoinable conference?                   1
  3944.                28      Max msgs users may extract per packet (9999 max)    4
  3945.                29      Force "violation notice" conference active? (Y, N)  1
  3946.                30      Allow MMGR online R)ead and P)ost options? (Y, N)   1
  3947.                
  3948.                31 and up = Conference configuration section.  Each conference
  3949.                is configured as follows (24 arguments = 23 commas on each
  3950.                line):
  3951.                
  3952.                1,2,3,4,"5","6",7,8,9,10,"11",12,13,14,"15",16,17,18,19,20,21,
  3953.                22,23,"24"  (all on one line).
  3954.                
  3955.                             MAX = Maximum number of characters,
  3956.                             INT = Integer (cannot exceed 32767)
  3957.                
  3958.                Arg #      Meaning                                           MAX
  3959.                ------     ------------------------------------------------  ---
  3960.                   1       Conference number (1 to 500).                       3
  3961.                   2       Conference name                                     7
  3962.                   3       Fido point number (applies to Fido areas only)    INT
  3963.                   4       Fido "fakenet" ID for 2D Fido points (Fido only)  INT
  3964.                   5       Path/Name of this conference's USERS file.         80
  3965.                   6       Path/Name of this conference's MESSAGES file.      80
  3966.                   7       Allow or dis-allow ANSI (Y or N).                   1
  3967.                   8       Allow or dis-allow high/low ASCII (Y or N).         1
  3968.                   9       Security level needed to read this conference.    INT
  3969.                  10       Security level needed to post in this conference. INT
  3970.  
  3971.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 80 -
  3972.  
  3973.  
  3974.                  11       Tagline for this conf (NONE = use default tag).    61
  3975.                  12       Modify mail reader tearlines? (Y or N).             1
  3976.                  13       Type of msg base (Y=fixed, N=elastic, F=FIDO).      1
  3977.                  14       Allow users to join from within the door? (Y, N).   1
  3978.                  15       Path/Name to alias file (leave empty if none).     80
  3979.                  16       Zone for this conf (applies to FIDO areas only)   INT
  3980.                  17       Net  for this conf (applies to FIDO areas only)   INT
  3981.                  18       Node for this conf (applies to FIDO areas only)   INT
  3982.                  19       Is this a FIDO *.MSG NETMAIL area? (Y or N).        1
  3983.                  20       Add tear/origin line (Y or N)  (FIDO areas only)    1
  3984.                  21       True FIDO symbolic area name (FIDO areas only)     15
  3985.                  22       Allow private messages in this conference? (Y/N)    1
  3986.                  23       Max # of lines per msg for this conference (1-99)   2
  3987.                  24       Conference description.                            25
  3988.                
  3989.                Your MAIN RBBS-PC MESSAGE BASE must be listed as conference #1!
  3990.                From there on, you can mix/match as you see fit.  Your MAIN
  3991.                conference might look something like this:
  3992.                
  3993.                
  3994.                1,MAIN,0,0,"C:\RBBS\MAINU.DEF","C:\RBBS\MAINM.DEF",Y,Y,5,5,
  3995.                "NONE",N,N,N,"NONE",0,0,0,N,N,"",Y,99,"Main message base"
  3996.                
  3997.                NOTE that it should all be on one line!  It is split here for
  3998.                the purposes of this documentation.  This line tells Mail
  3999.                Manager that:
  4000.                
  4001.                This is conference #1, named "MAIN".
  4002.                Your system is not a Fido "point" (i.e. point #0).
  4003.                Your system is not using a Fido "fakenet" (i.e. fakenet = 0).
  4004.                The path to the users file is "C:\RBBS\MAINU.DEF".
  4005.                The path to the messages file is "C:\RBBS\MAINM.DEF".
  4006.                Both ANSI and high/low ASCII are allowed in uploaded replies.
  4007.                Users with security level 5 and above can both read and reply.
  4008.                Default tagline will be used.
  4009.                We are not bothering with FIDO-STYLE tearlines.
  4010.                This is an "elastic" message base.
  4011.                Users cannot join this conference from within the door.
  4012.                There is no alias file for this conference.
  4013.                This is not an *.MSG Fido-style area.
  4014.                Private messages will be allowed.
  4015.                99 maximum lines per message.
  4016.                Conference description is "Main message base".
  4017.                
  4018.                ----------------------------------------------------------------
  4019.                
  4020.                ...and that's the way it works.  Conferences do NOT have to be
  4021.                listed in numerical order: TXT2CFG will handle them no matter
  4022.                where they are in the list.  HOWEVER, if you need "gaps" between
  4023.                conference numbers, pay close attention to the following:
  4024.                
  4025.                *PLEASE NOTE* - TXT2CFG will *NOT* automatically "fill-in-the-
  4026.                blanks" for you.  This INCLUDES conference numbers!  If you
  4027.                intend to reserve a space for a conference, set the conference
  4028.                name to "{EMPTY}".  The bare minimum line to reserve a
  4029.  
  4030.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 81 -
  4031.  
  4032.  
  4033.                conference would look like this:
  4034.                
  4035.                X,{EMPTY},,,,,,,,,,,,,,,,,,,,,,
  4036.                  
  4037.                  (Yes, that's 23 commas).  Replace "X" with the conference
  4038.                  number.
  4039.                  
  4040.                If you intend to leave gaps in conference numbers, you will have
  4041.                to add one of these lines for every conference in question.
  4042.                TXT2CFG will completely ignore any unused conference numbers,
  4043.                meaning that if your text configuration looks like this:
  4044.                
  4045.                    1,MAIN,.....
  4046.                    3,CONF3,.....
  4047.                
  4048.                TXT2CFG will convert them to:
  4049.                
  4050.                    1,MAIN,.....
  4051.                    2,CONF3,.....
  4052.                
  4053.                But, if you configure it like this:
  4054.                
  4055.                    1,MAIN,.....
  4056.                    2,{EMPTY},.....
  4057.                    3,CONF3,.....
  4058.                
  4059.                TXT2CFG will import them that way, and "reserve" conference #2.
  4060.  
  4061.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 82 -
  4062.  
  4063.  
  4064.          MAILFIX
  4065.          -------
  4066.          
  4067.          MAILFIX is an alternate purge/repair utility for RBBS-PC message
  4068.          bases.  Because of its obvious utility for all RBBS sysops, we are
  4069.          releasing it as a separate stand-alone utility with full documentation
  4070.          as well.
  4071.          
  4072.          This version is much faster than releases before v4.0, and has a few
  4073.          more useful options as well.
  4074.          
  4075.          USAGE:
  4076.          
  4077.            MAILFIX [options] D:\PATH\MESSAGE.FIL
  4078.          
  4079.            Available options:
  4080.          
  4081.             /V - Only View the integrity of the message file.  Do not perform
  4082.                    the actual repair work, and do not create an output file.
  4083.                    
  4084.             /D - Use DOS screen writes instead of direct.  Slows the program
  4085.                    down a tad, but allows for DOS redirection of output.
  4086.                    
  4087.             /F - Informs MAILFIX that this is a fixed-length message base.  If
  4088.                    "/F" is not chosen, MAILFIX assumes the message base to be
  4089.                    configured as 'elastic'.
  4090.                    
  4091.             /R - Informs MAILFIX that the sysop uses RBBSMail or MsgToss on
  4092.                    this message base.  Both of these mail processors format the
  4093.                    time field in the message header with a period instead of a
  4094.                    colon, which CONFIG's option #185 (repair messages) chokes
  4095.                    on.
  4096.             
  4097.             /O - Informs MAILFIX that the sysop uses OverMail on this message
  4098.                    base.  OverMail formats the time field in the message header
  4099.                    with a semicolon instead of a colon, which CONFIG's option
  4100.                    #185 (repair messages) chokes on.
  4101.                    
  4102.             /P - Causes MAILFIX to purge private messages which have been read
  4103.                    by the addressees.
  4104.             
  4105.             /Knnn - (Where "nnn" is the number of messages to keep.): Tells
  4106.                    MAILFIX to trim down the physical size of the message base,
  4107.                    regardless of whether or not the messages to delete are
  4108.                    flagged as "killed".  This is useful for things like an echo
  4109.                    area that grows almost out of control daily. If you want to
  4110.                    keep 50 messages, your switch would be "/K50".
  4111.                    
  4112.                    This switch may not be used in conjunction with "/V"!
  4113.                    
  4114.                    Use of this option will OVERWRITE your original message
  4115.                    file!
  4116.                    
  4117.  
  4118.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 83 -
  4119.  
  4120.  
  4121.             /N - Tells MAILFIX to renumber the message base, starting at
  4122.                    message number 1.  If used with the /K option, the retained
  4123.                    messages will be renumbered starting with 1.
  4124.                    
  4125.                    Use of this option will OVERWRITE your original message
  4126.                    file!
  4127.                    
  4128.                    Optionally, you may immediately follow the /N with the
  4129.                    drive:\path\filename of the user file for this message base
  4130.                    if you wish MAILFIX to update the user's message pointers to
  4131.                    reflect the renumbering (We STRONGLY urge you to do so!).
  4132.                    There can be no spaces between the /N and the beginning of
  4133.                    the filename.  Your original user file will be updated in
  4134.                    place, so if you want a backup of your unaltered user file,
  4135.                    you must make one first.
  4136.                    
  4137.                    D:\PATH\MESSAGE.FIL is the name of the messages file to
  4138.                    purge/repair.
  4139.                    
  4140.             /Snnn - (where "nnn" is message base size.)  By default MAILFIX can
  4141.                    handle a message base of up to 1000 messages.  If your
  4142.                    message base has more messages than this (via modification
  4143.                    of your RBBS version, or additional messages being added by
  4144.                    a mail processor), you must inform MAILFIX of this via the
  4145.                    /S switch.  If you fail to do this, MAILFIX will not
  4146.                    allocate enough memory to handle the extra messages.  For
  4147.                    instance, to run on a base of up to 2000 messages, your
  4148.                    syntax would be /S2000.
  4149.             
  4150.          Unless the /V option is used, MAILFIX will create an output file with
  4151.          the same name and the extension '.FIX'.  Above example would create
  4152.          D:\PATH\MESSAGE.FIX.
  4153.          
  4154.          If the /Knnn or /N switches are used, MAILFIX will make a second pass
  4155.          on your message base, using the *.FIX file for input, and the original
  4156.          file name for output.  When finished your original message file will
  4157.          have been replaced by MAILFIX's work, and the *.FIX file will be
  4158.          deleted.
  4159.          
  4160.          EXAMPLES:
  4161.          
  4162.          Unless you use the "/Knnn" or "/N" command line options, MAILFIX will
  4163.          not overwrite (or modify in any way) your original message file.  If
  4164.          you want to replace your old message file with the one that MAILFIX
  4165.          creates, your best bet is to run MAILFIX from a batch file, like so:
  4166.          
  4167.             MAILFIX C:\RBBS\MAINM.DEF
  4168.             IF EXIST C:\RBBS\MAINM.FIX DEL C:\RBBS\MAINM.DEF
  4169.             IF EXIST C:\RBBS\MAINM.FIX REN C:\RBBS\MAINM.FIX C:\RBBS\MAINM.DEF
  4170.             
  4171.          On the other hand, if you have an echo area that's scanned by
  4172.          RBBSMail, and you want to keep it purged down to 100 messages, your
  4173.          command line would be:
  4174.          
  4175.             MAILFIX /R /K100 C:\RBBS\FILENAME.DEF
  4176.  
  4177.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 84 -
  4178.  
  4179.  
  4180.          
  4181.          If you want to also renumber the message base, and to update the
  4182.          pointers in your user file for this base:
  4183.          
  4184.             MAILFIX /R /K100 /NC:\RBBS\USERFILE.DEF C:\RBBS\FILENAME.DEF
  4185.          
  4186.          If you wanted to do the same thing with a message base that's been
  4187.          scanned by OverMail:
  4188.          
  4189.             MAILFIX /O /K100 /NC:\RBBS\USERFILE.DEF C:\RBBS\FILENAME.DEF
  4190.          
  4191.          These last three examples would replace "FILENAME.DEF" with the
  4192.          fixed/purged/pruned message base.
  4193.          
  4194.          Run MAILFIX with no additional command line parameters to get a help
  4195.          screen.
  4196.          
  4197.             *=- ABOUT MAILFIX and MESSAGE BASES with CARBON COPIES -=*
  4198.                 --------------------------------------------------
  4199.          
  4200.          MailFix *DOES* work with message bases that have been configured with
  4201.          the "carbon copy" feature of RBBS-PC v17.4+.  MailFix does not go
  4202.          through any special gyrations to look for multiple-recipient messages,
  4203.          but it will not trash your message base, either.  When renumbering, it
  4204.          will reset the message number in all "carbon copies".
  4205.          
  4206.          In over two years of Mail Manager / Mailfix's life thus far, we have
  4207.          found that there are MANY utilities floating around out there that do
  4208.          not strictly adhere to the RBBS-PC message format as-defined in the
  4209.          documentation for our favorite BBS software.  MailFix was specifically
  4210.          written to be as generic as possible, and to work with the widest
  4211.          possible variety of RBBS-PC message bases.
  4212.          
  4213.          The only known incompatibility with RBBS-PC v17.4 message bases is the
  4214.          following scenario:
  4215.          
  4216.          The message base is configured with "carbon-copy" turned on, and
  4217.          
  4218.             1) - The very first header of the "carbon-copy" message is bad, or
  4219.  
  4220.             2) - The very first header of the "carbon-copy" message is marked
  4221.                  as "killed".
  4222.  
  4223.          In the first case, MailFix will skip the "bad" message, and maybe the
  4224.          one following it as well, until it can get its bearings and find the
  4225.          next "good" message header.
  4226.  
  4227.          In the second case, Mailfix will purge the entire message, even if
  4228.          some of the other carbon copies have not been marked as killed.
  4229.  
  4230.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 85 -
  4231.  
  4232.  
  4233.          MMINDEX
  4234.          -------
  4235.  
  4236.          MMINDEX is the Mail Manager Plus indexing utility for Fido-style *.MSG
  4237.          message areas.  If you are not running any of these types of message
  4238.          areas, you do not need MMINDEX, and can skip this section.
  4239.  
  4240.          Usage: MMINDEX [FILENAME.CFG] [/n] [/LFILENAME.LOG]
  4241.  
  4242.             FILENAME.CFG is the Mail Manager configuration file to process.
  4243.             Default is MAILMGR.CFG in the current DOS subdirectory.
  4244.  
  4245.             /n = An individual conference number to process. (I.E. - /5).
  4246.                  If omitted, processes all Fido *.MSG conferences.  You can
  4247.                  only specify ONE individual conference on the command line,
  4248.                  such as:
  4249.  
  4250.                      MMINDEX E:\MMGR\MAILMGR.CFG /5
  4251.  
  4252.                  This would cause MMINDEX to read the E:\MMGR\MAILMGR.CFG
  4253.                  configuration file, and process only conference #5.
  4254.  
  4255.             /LFILENAME.LOG = Read a text "ECHOTOSS.LOG" type of file, and
  4256.                  process only the Fido areanames listed within.  If omitted,
  4257.                  processes all Fido *.MSG conferences.  This lends itself to
  4258.                  "smarter" automatic operation after tossing new messages into
  4259.                  your *.MSG areas.  There can be no space between /L and the
  4260.                  name of the log file.  Sample usage:
  4261.  
  4262.                      MMINDEX E:\MMGR\MAILMGR.CFG /LC:\FIDO\ECHOTOSS.LOG
  4263.  
  4264.                  An ECHOTOSS.LOG file contains a list of Fido area names.
  4265.                  Therefore, if you are going to use the "/L" option, it is
  4266.                  very important to properly configure the "Fido area name"
  4267.                  for all of your *.MSG areas in the MAILCFG program, which
  4268.                  is the 3rd option on the conference configuration screen.
  4269.  
  4270.          * NOTE - /n and /L cannot be used together.
  4271.  
  4272.          If nothing is supplied on the command line, MMINDEX will look for a
  4273.          file named MAILMGR.CFG in the current directory, and process all Fido
  4274.          conferences.
  4275.  
  4276.          MMINDEX reads the Mail Manager +Plus+ binary configuration file, and
  4277.          looks for all conferences configured as F)ido (*.MSG).  It then
  4278.          creates a file named MMGR.NDX in each FIDO *.MSG subdirectory, which
  4279.          is what Mail Manager +Plus+ uses to move as quickly as possible
  4280.          through the messages within.  The index is 4 bytes per message, so if
  4281.          you have 100 messages in a FIDO conference, MMGR.NDX should be 400
  4282.          bytes in length.
  4283.  
  4284.          Mail Manager +Plus+ creates/updates these index files itself, but you
  4285.          will save yourself (and your users) a lot of time by putting MMINDEX
  4286.          in your nightly event AFTER your toss/scan/renumber processes.  If
  4287.          the door finds that the indexes in each area are invalid, it will have
  4288.          to re-create them from scratch.
  4289.  
  4290.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 86 -
  4291.  
  4292.  
  4293.          MMGRNODE
  4294.          --------
  4295.          
  4296.          MMGRNODE.EXE is meaningful only if you are running one or more FIDO
  4297.          *.MSG netmail areas.  If you are not configuring any such areas into
  4298.          Mail Manager +Plus+, you have no need for this utility.
  4299.          
  4300.          Mail Manager +Plus+ uses a proprietary compiled nodelist format for
  4301.          all Zone:Net/Node searches in your netmail areas.  Although it is not
  4302.          absolutely necessary to use our implementation, you will lose the
  4303.          convenience of being able to confirm that you are sending netmail to
  4304.          the correct Zone:Net/Node, and will have to blindly enter in your
  4305.          Zone:Net/Node arguments for netmail messages that you upload into Mail
  4306.          Manager +Plus+.
  4307.          
  4308.          MMGRNODE reads a "raw" nodelist, and compiles it into a format that is
  4309.          optimized for small file size and fast searches.  MMGRNODE can use a
  4310.          single nodelist, or can combine several different ones together.
  4311.          
  4312.          Usage:  MMGRNODE [/A] X:\PATH\NODELIST.FIL
  4313.          
  4314.           /A = Instructs MMGRNODE to append to any pre-existing compiled
  4315.                nodelist that it created previously.  If no "/A" on command
  4316.                line, MMGRNODE will create the compiled nodelist and index from
  4317.                scratch, overwriting any pre-existing ones.
  4318.                
  4319.           X:\PATH\NODELIST.FIL = The path/filename of the raw nodelist that you
  4320.                wish to compile.
  4321.                
  4322.          MMGRNODE should always be run from your Mail Manager +Plus+ directory.
  4323.          It creates the following two files whenever it is run:
  4324.          
  4325.                MMGRNODE.DAT  - The main data file containing Zone, Net, and
  4326.                node numbers, as well as SysOp name, and BBS phone number.
  4327.                
  4328.                MMGRNODE.DIX  - The main data file's index (MUCH smaller in
  4329.                size).
  4330.                
  4331.          If you intend to compile several different nodelists together, it is
  4332.          important to consider which list contains the addresses that you will
  4333.          want to access frequently, and also the physical size of the nodelist
  4334.          itself.  For instance, if you ever need to send something to someone
  4335.          in RBBS-NET, and you intend to compile both the RBBS-NET and FIDO-NET
  4336.          nodelists, you may want to compile the RBBS-NET list first, since the
  4337.          file size is so small.  The search time to get through RBBSLIST is
  4338.          minimal in comparison to having to scan the entire FIDO nodelist just
  4339.          to find someone in RBBS-NET.  To compile using this scenario, your
  4340.          command lines would be:
  4341.          
  4342.             MMGRNODE X:\PATH\RBBSLIST.178
  4343.             MMGRNODE /A X:\PATH\NODELIST.094
  4344.          
  4345.          This would create the two files MMGRNODE.DAT and MMGRNODE.DIX from
  4346.          scratch, starting with the RBBS-NET nodelist.  The FIDO-NET nodelist
  4347.          would then be appended to them.
  4348.  
  4349.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 87 -
  4350.  
  4351.  
  4352.          MNET
  4353.          ----
  4354.          
  4355.          MNET.EXE is a QWK->REP file conversion utility for QWK networks.  This
  4356.          program is available separately, and can be used with BBS types other
  4357.          than RBBS-PC.
  4358.          
  4359.          Usage:  MNET HOSTNAME [I|O]
  4360.          
  4361.          HOSTNAME = The name of the configuration file that MNET is to use for
  4362.                this session.  (If your host sends QWK packets named FOOBAR.QWK,
  4363.                you'd call this file FOOBAR.CFG.)  HOSTNAME.CFG will then be
  4364.                read for operating parameters, and the program will look for the
  4365.                HOSTNAME.QWK in the directory you specify.
  4366.                
  4367.            I = Import mode; convert existing HOSTNAME.QWK to BBSNAME.REP (where
  4368.                BBSNAME.REP would be the correct name for a .REP to be uploaded
  4369.                to YOUR system.
  4370.                
  4371.            O = Export mode; convert existing BBSNAME.QWK to HOSTNAME.REP, for
  4372.                later uploading to the host system.
  4373.                
  4374.          You can have as many configuration files as necessary for your
  4375.          installation.  The format of each configuration file is like so:
  4376.          
  4377.              <<START OF EXAMPLE>>
  4378.          
  4379.          NODE                                           ; NODE PACKET NAME
  4380.          NODESYSOPFIRST NODESYSOPLAST                   ; NODE SYSOP NAME
  4381.          HOSTSYSOPFIRST HOSTSYSOPLAST                   ; HOST SYSOP NAME
  4382.          C:\MAILMGR\NODE5\                              ; NODE PACKET DIRECTORY
  4383.          C:\MAILMGR\NODE5\                              ; HOST PACKET DIRECTORY
  4384.          My own personal BBS (123) 456-7890             ; NODE TAGLINE
  4385.          The remote system I am calling (123) 456-7890  ; HOST TAGLINE
  4386.          PKZIP -es [FILE]                               ; PACK COMMAND LINE
  4387.          PKUNZIP -o [FILE]                              ; UNPACK COMMAND LINE
  4388.          
  4389.          ; ALL REMAINING LINES CONSIST OF THREE TO FIVE PARAMETERS, SEPARATED ;
  4390.          ; BY COMMAS (all on ONE line):
  4391.          ;   NODE CONFERENCE NUMBER,
  4392.          ;   HOST CONFERENCE NUMBER,
  4393.          ;   PRIVATE MESSAGES ALLOWED (Y=Yes, N=No, C=Convert priv to pub),
  4394.          ;   NODE CONFERENCE TAGLINE (optional),
  4395.          ;   HOST CONFERENCE TAGLINE (optional)
  4396.          
  4397.          19, 4, Y, Node Conference Tag, Host Conference Tag
  4398.          
  4399.              <<END OF EXAMPLE>>
  4400.          
  4401.          MNET converts the word "SYSOP" to the true sysop name in question, as
  4402.          listed in the HOSTNAME.CFG file, whenever it is found in the TO or
  4403.          FROM names, appropriately.
  4404.          
  4405.          The supplied NETINFO.DOC explains the use of this program in greater
  4406.          detail.
  4407.  
  4408.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 88 -
  4409.  
  4410.  
  4411.          MUSER
  4412.          -----
  4413.          
  4414.          MUSER.EXE is the Mail Manager +Plus+ editor for the door's internal
  4415.          users file, MAILMGR.USR.  The utility is meant to be run from within
  4416.          your Mail Manager +Plus+ directory, and will look for MAILMGR.USR when
  4417.          it loads.  Optionally, you can specify the path/name of the users file
  4418.          on the command line.
  4419.          
  4420.          The program was created for the purpose of setting up "net status
  4421.          usernames" for the HOST sysop in QWK networks, but quickly evolved
  4422.          into a useful utility for general aspects of Mail Manager +Plus+ user
  4423.          file maintenance.
  4424.          
  4425.          One particularly useful capability is the purging of inactive users
  4426.          from the user file.  This can speed up operation, since the door will
  4427.          not have to scan through as many records in the file in order to find
  4428.          everyone when the door loads.  This may be done manually from within
  4429.          MUSER, or automatically via the /Pnn command line switch:
  4430.          
  4431.                     MUSER /P90
  4432.          
  4433.          would automatically purge the file of all users who had not used the
  4434.          door for 90 days or more.  This can be run from a batch file for
  4435.          unattended operation.
  4436.          
  4437.          When loaded, it looks like this:
  4438.          
  4439.          MUSER - Utility to edit MAIL MANAGER +PLUS+ User Files.
  4440.          Version 3.50  Copyright (C) 1993, Makai Software. All rights reserved.
  4441.          ══════════════════════════════════════════════════════════════════════
  4442.          A) USER:  JOE MODEM                                      RECORD:     5
  4443.          ──────────────────────────────────────────────────────────────────────
  4444.          B) Packet type:         QWK           L) Abort if no msgs:    Yes
  4445.          C) Update pointer:      Yes           M) Ask before send:     No
  4446.          D) Xfer protocol:       Z             N) Default msg select:  All msgs
  4447.          E) Msg to ALL as pers:  No            O) Turbokey:            On
  4448.          F) Display Menu:        No            P) Max Msgs pkt/conf:   0/0
  4449.          G) Archive choice:      ZIP           Q) Net Status:          None
  4450.          H) Last-on (YYMMDD):    921102        R) Net identification:
  4451.          I) Send own msgs:       No            S) .MSG Date (YYMMDD):  921102
  4452.          J) Send bulletins:      No            T) .MSG Time (HHMMSS):  030100
  4453.          K) Send new file info:  No            U) .MSG Length:         2643
  4454.          ══════════════════════════════════════════════════════════════════════
  4455.                  TO SELECT USER: Press , , PgUp, PgDn.  (<ESC> to QUIT)
  4456.          
  4457.                  OPTIONS:                   EDIT USER SHOWN:
  4458.                  1) Find User Name          A-T) Edit data above
  4459.                  2) Add new user            4)   Edit conf data
  4460.                  3) Purge User Records      5)   Delete user
  4461.          ══════════════════════════════════════════════════════════════════════
  4462.          
  4463.          The above screen shows all of the user's settings, and each one can be
  4464.          changed as needed by pressing the letter corresponding to it (A-U).
  4465.          You can use the up, down, PgUp, PgDn keys to move forward and backward
  4466.  
  4467.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 89 -
  4468.  
  4469.  
  4470.          through the user file.  Press "5" to delete the user, or "4" to edit
  4471.          his/her conference selection settings.
  4472.          
  4473.          Additional numeric options (1-3) work as you would expect:
  4474.          
  4475.                1 - Find a user.  You'll be asked for a search string.
  4476.                2 - Add new user.  Adds a blank user record to the end of the
  4477.                    file then lets you fill in the data.
  4478.                3 - Purge.  You will be asked to purge by date, or elapsed days.
  4479.                
  4480.          Options "A" through "P" pertain to the user's settings as they
  4481.          configured themselves from within Mail Manager +Plus+.
  4482.          
  4483.          The user has no control over options "Q" through "U" from within the
  4484.          door.
  4485.          
  4486.          Options "Q" and "R" pertain to QWK network users.  Usage of this
  4487.          utility for network operation is described in NETINFO.DOC.
  4488.          
  4489.          Options "S", through "U" pertain to Mail Manager +Plus+ duplicate
  4490.          upload checking, and normally should not need to be modified.  If for
  4491.          some reason you wish to "fool" Mail Manager into letting a user upload
  4492.          the identical QWK packet a second time in succession, change the
  4493.          information in one of these fields so Mail Manager will not recognize
  4494.          the packet as a duplicate.
  4495.  
  4496.      UTILITY PROGRAMS BUNDLED WITH MAIL MANAGER +PLUS+              - Page 90 -
  4497.  
  4498.  
  4499.          UPDATE AND UPDATUSR
  4500.          -------------------
  4501.          
  4502.          The pair of utilities UPDATE.EXE and UPDATUSR.EXE are intended as
  4503.          "one-shot" programs for SysOps who are upgrading from v1.30 through
  4504.          v1.36 of Mail Manager.  If you are not upgrading from one of these
  4505.          previous versions of Mail Manager, you do not need these two
  4506.          utilities.
  4507.          
  4508.          By the time you read this, you will likely have already converted your
  4509.          files, but here is the scenario anyway:
  4510.          
  4511.              - BACK UP YOUR ORIGINAL MAILMGR.CFG and MAILMGR.USR FILES!  (Just
  4512.              in case something goes wrong).
  4513.              
  4514.              - BOTH programs must be run from your Mail Manager directory.
  4515.              
  4516.              - UPDATE.EXE updates your binary configuration file (MAILMGR.CFG)
  4517.              to the new format used by Mail Manager +Plus+.
  4518.              
  4519.              - UPDATUSR.EXE updates Mail Manager's binary user file
  4520.              (MAILMGR.USR) to the new format used by Mail Manager +Plus+.
  4521.              
  4522.          These utilities are "run-once-then-throw-them-away".  Once your files
  4523.          are converted, you won't need them again.
  4524.  
  4525.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 91 -
  4526.  
  4527.  
  4528.          THE MAIN MENU
  4529.          -------------
  4530.          
  4531.          Although we hope that you'll find Mail Manager to be pretty self-
  4532.          explanatory, a complete run-down on everything that you can do with
  4533.          this door follows.
  4534.          
  4535.          A shorter version of this is available to the user, in the online help
  4536.          files MMGR1.HLP and MMGR2.HLP.
  4537.          
  4538.          The menu itself looks something like this:
  4539.          
  4540.                ---------------------------------------------
  4541.              /     MAIL MANAGER +PLUS+ MAIN MENU        /    \
  4542.            /                                          /        \
  4543.            l  C)onfigure MAIL MANAGER                 l        l
  4544.            l  D)ownload mail                          l        l
  4545.            l  E)xpedite!  (Download then exit to bbs) l        l
  4546.            l  G)oodbye                                l        l
  4547.            l  Q)uit (return to bbs)                   l        l
  4548.            l  H)elp!                                  l        l
  4549.            l  P)ost a message                         l        l
  4550.            l  R)ead messages by conference            l        l
  4551.            l  U)pload your replies.                   l        l
  4552.            l  W)ho's online to RBBS-PC?               l        l
  4553.            l  X)pert toggle (this menu on/off)        l        l
  4554.            -------------------------------------------------------------------.
  4555.                                    HHHHHH          "--------------------------"
  4556.                                    HHIIII
  4557.                                    HHIIII
  4558.          
  4559.            Your choice, Username <C,D,E,Q,H,M,W,U,X,?>?
  4560.          
  4561.          PLEASE NOTE:  Users of versions earlier than 3.10 will notice the
  4562.          option to select which messages to extract (i.e. set message pointers)
  4563.          has been moved from the main menu to the configuration menu.  If you
  4564.          have installed a customized menu, you should revise it to reflect
  4565.          this.
  4566.          
  4567.          MAIN MENU commands are as follows:
  4568.          
  4569.            C - Configure Mail Manager.
  4570.                
  4571.                Brings up a separate configuration menu for the user's personal
  4572.                options.  These options are discussed separately immediately
  4573.                after Main Menu Commands.
  4574.                
  4575.            D - Download new mail.
  4576.                
  4577.                Will find and extract all new mail from your selected
  4578.                conferences, in the format that you told Mail Manager to use
  4579.                (Text or QWK).  Mail Manager will then compress the file(s) in
  4580.                your selected file compression format.
  4581.                
  4582.  
  4583.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 92 -
  4584.  
  4585.  
  4586.                Unless your file protocol is set to N)one, Mail Manager will
  4587.                then send you the mail packet.  If your default protocol is set
  4588.                to N)one, you'll be asked for the transfer protocol of your
  4589.                choice.  If you choose "N", the file will not be sent to you,
  4590.                and you'll be returned to the main menu.  Otherwise Mail Manager
  4591.                will do its best to send a compressed version of the mail to you
  4592.                via your selected choice.
  4593.                
  4594.                Upon completion of the download operation in QWK mode, Mail
  4595.                Manager will then check for the existence of a REP file and
  4596.                process it if found.  This provides compatibility with bi-
  4597.                directional transfer protocols which can upload a REP while
  4598.                downloading a QWK.
  4599.                
  4600.            E - Expedite!
  4601.                
  4602.                Same as Download (above), except automatically exits Mail
  4603.                Manager when finished.
  4604.                
  4605.                If you have configured the door to drop DTR when G)oodbye is
  4606.                chosen, this option will drop DTR after the download to
  4607.                disconnect the caller upon exit, otherwise it will return the
  4608.                caller to the BBS.
  4609.                
  4610.            G - Goodbye
  4611.                
  4612.                Returns to BBS (same as Q)uit), unless you have configured the
  4613.                door to drop DTR.  If so, it will drop DTR on the user
  4614.                (disconnects most modems).
  4615.                
  4616.            Q - Quit (return to BBS)
  4617.                
  4618.                What can we say?  This takes the user back to your bbs.
  4619.                
  4620.            H (or '?') - Display help file
  4621.                
  4622.                Displays an abbreviated version of these command descriptions.
  4623.                
  4624.            I - Sysop Information
  4625.                
  4626.                This command is not shown in the online help file, is not
  4627.                displayed in the command prompt, and is not shown in the menu
  4628.                itself.
  4629.                
  4630.                Only those with sufficient security to read ALL messages will be
  4631.                able to activate this command.  Everyone else will get the
  4632.                familiar "Command not recognized".
  4633.                
  4634.                The purpose of this command is to assist you in debugging your
  4635.                setup, and it is covered in detail elsewhere in this manual
  4636.                under "DEBUGGING YOUR SETUP".
  4637.                
  4638.            
  4639.  
  4640.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 93 -
  4641.  
  4642.  
  4643.                
  4644.            R - Read messages.
  4645.                
  4646.                Allows users to read messages while online within the door.
  4647.                This can be useful for checking out a message or two before
  4648.                downloading a packet.  User will be asked for which conference
  4649.                to read whenever this option is chosen.
  4650.                
  4651.                If the user has sufficient security to post a message in the
  4652.                conference they select here, they will have the option to reply
  4653.                to messages that they read, and choose to quote or not quote the
  4654.                message that they are replying to.
  4655.                
  4656.                Mail Manager +Plus+'s read function itself is somewhat
  4657.                rudimentary; we did not try to duplicate RBBS-PC itself in this
  4658.                regard.  The user can choose to read all messages, or personal
  4659.                messages only, reading "forward" starting with a particular
  4660.                message number, or S)ince last read.
  4661.                
  4662.            P - Post a message
  4663.                
  4664.                A complement to the R)ead option, allows user to post a message
  4665.                while online within the door, and will allow them to select only
  4666.                the conferences in which they have sufficient security to post.
  4667.                
  4668.                Mail Manager +Plus+ is equipped with a line editor, similar in
  4669.                function to RBBS-PC's.  Message length will be limited to 8 less
  4670.                than the lines per message allowed in that area (as configured
  4671.                for Mail Manager) for normal "non-net-status" users.  The same
  4672.                line editor used in the P)ost function is used when R)eplying to
  4673.                a message while reading online.
  4674.                
  4675.            U - Upload your replies
  4676.                
  4677.                Works with QWK-compatible mail reader/repliers only. Your
  4678.                uploaded file is expected to be compatible with the .REP format
  4679.                used by popular mail readers such as SLMR.  Mail Manager will
  4680.                look for the REP packet after the upload and attempt to place
  4681.                your replies into the proper message bases.
  4682.                
  4683.                If your default protocol is set to N)one, you'll be asked for
  4684.                the protocol that you wish to use.  If you select N)one, you'll
  4685.                be returned to the main menu.
  4686.                
  4687.                If you're in local mode as the Sysop, place the .REP file in the
  4688.                \MAILMGR\LOCAL directory, and choose this option.  This is
  4689.                covered further in the section regarding "DEBUGGING YOUR SETUP".
  4690.                
  4691.  
  4692.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 94 -
  4693.  
  4694.  
  4695.            W - Who's online?
  4696.                
  4697.                Displays a list of who's online to all nodes of this RBBS-PC.
  4698.                (Much like RBBS's command of the same name).
  4699.                
  4700.                Those with sufficient security to read ALL messages will have
  4701.                the following displayed:
  4702.                
  4703.                    - User's name,
  4704.                    - City/State, and
  4705.                    - BPS rate.
  4706.                
  4707.                    If a node is inactive, the last user's information is
  4708.                    displayed, and will be reported as "Last call".
  4709.                
  4710.                All other users will have the following displayed:
  4711.                
  4712.                    - User's name, and
  4713.                    - baud rate.
  4714.                
  4715.                If a node is inactive, "Waiting for next caller" is displayed.
  4716.                
  4717.            X - Expert toggle
  4718.                
  4719.                Turns the main menu on or off.  (Much like RBBS's command of the
  4720.                same name).  This setting is saved for the user's next time into
  4721.                the door.
  4722.                
  4723.          
  4724.  
  4725.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 95 -
  4726.  
  4727.  
  4728.          CONFIGURATION MENU COMMANDS:
  4729.          ----------------------------
  4730.          
  4731.          The configuration menu allows the user to select personal options, and
  4732.          select or change conferences from which to extract new mail.
  4733.          
  4734.          You'll be presented with a screen that looks something like this:
  4735.          
  4736.          ----------------------------------------------------------------------
  4737.          Configuration options:
  4738.          
  4739.          A - Choose active conferences.
  4740.          X - Message selection menu.
  4741.          B - Download messages in Q)WK or T)ext format .........: Q
  4742.          C - Msgs addressed to ALL marked as personal (QWK only): No
  4743.          D - Extract ONLY your personal mail as default ........: No
  4744.          E - Extract messages written by YOU ...................: Yes
  4745.          F - Abort packet if no messages .......................: No
  4746.          G - Send updated bulletins ............................: Yes
  4747.          H - Send new file listings ............................: Yes
  4748.          I - Ask before sending packet .........................: No
  4749.          J - Type of file compression to use ...................: ZIP
  4750.          K - Default file transfer protocol ....................: N
  4751.          L - Update high message numbers after downloading .....: Yes
  4752.          M - Update high message numbers after R)eading ........: No
  4753.          N - Max messages desired per packet/conference ........: 1000/1000
  4754.          T - Use 'TurboKeys' (act on 1 char commands) ..........: Yes
  4755.              -----------------------------
  4756.          ? - Display help file.
  4757.          Q - Quit.  (Finished configuring)
  4758.          
  4759.           Enter your choice(s), UserName <A,B,C,D,E,F,G,H,I,J,K,L,M,Q,T,X,?> ->
  4760.          ----------------------------------------------------------------------
  4761.          
  4762.  
  4763.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 96 -
  4764.  
  4765.  
  4766.          Now let's see what these various commands do:
  4767.          
  4768.           A - Select conferences to extract and download.
  4769.  
  4770.                You'll be presented with a list of conferences that you are able
  4771.                to access, which will look something like this:
  4772.  
  4773.            --------------------------------------------------------------------
  4774.            You may select any conference which is shown in UPPER CASE.
  4775.            Conferences shown in lower case must first be joined from the bbs.
  4776.            Conferences you've marked as active are surrounded in brackets '[]'.
  4777.            Conferences marked as --- are not available.
  4778.  
  4779.                      1 - [MAIN   ] 11 -  TEEN     21 - [RSYS   ]
  4780.                      2 - [4SALE  ] 12 - [PRIVATE] 22 - [BITS   ]
  4781.                      3 - [MS-DOS ] 13 - [SYSOP  ] 23 - [POL    ]
  4782.                      4 -  BBS      14 - [USER   ] 24 - [CRES   ]
  4783.                      5 -   ---     15 -   grafx   25 - [WINB   ]
  4784.                      6 - [CODE   ] 16 -   arj     26 - [MAILMGR]
  4785.                      7 - [DEBATE ] 17 -   ---
  4786.                      8 - [HAM    ] 18 - [QB     ]
  4787.                      9 -  HUMOR    19 - [RBBS   ]
  4788.                     10 - [IBM    ] 20 - [DEV    ]
  4789.            
  4790.            Enter conf. number(s) to toggle on/off, [ENTER] for next page, F to
  4791.            find, or Q to quit ->
  4792.            
  4793.            --------------------------------------------------------------------
  4794.                
  4795.                NOTE:  If you have configured your board NOT to show
  4796.                   empty/unjoinable conferences, the line "Conferences marked as
  4797.                   --- are not available" will not be shown.
  4798.                
  4799.                In this example, all conferences that you have joined (or which
  4800.                you have configured to be joinable via the Mail Manager +Plus+
  4801.                door, are flagged as active, except BBS (conference 4), HUMOR
  4802.                (conference 9), and TEEN (conference 11).
  4803.                
  4804.                If you wanted to mark those three as active, you'd enter:
  4805.                           4 9 11
  4806.                at the above prompt.
  4807.                
  4808.                Conferences #5 and 17 are shown as unavailable, meaning that the
  4809.                user either has insufficient security to access them, or you
  4810.                (the Sysop) have "reserved" these conference numbers in the
  4811.                MAILCFG program, for future use.  (If you have configured your
  4812.                board not to show empty/unjoinable conferences, these
  4813.                conferences would not be displayed at all.)
  4814.                
  4815.                Conferences #15 and 16 are valid conferences, which the user has
  4816.                not joined, and which the sysop has not configured to allow
  4817.                joining from within the door, as indicated by being shown in
  4818.                lower case.  To access these conferences the user must first
  4819.                join them from RBBS.
  4820.                
  4821.  
  4822.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 97 -
  4823.  
  4824.  
  4825.                Use the F)ind option to locate a conference via text search.
  4826.                When you press F, you will be prompted for search text.  You can
  4827.                enter up to a 15 character string which Mail Manager will search
  4828.                for in the conference names and descriptions.  If found, you
  4829.                will then be able to toggle the conference on/off, keep looking
  4830.                for the next match, or abort the search.  On boards with several
  4831.                screens of conference listings, this can be the fastest way to
  4832.                find the conference you want.
  4833.                
  4834.            X - Message selection menu (for active conferences).
  4835.  
  4836.                Mail Manager will normally download mail based on the last
  4837.                message that you've read in each conference.  Since you can read
  4838.                mail both online AND offline, and have the option of telling
  4839.                Mail Manager NOT to update your last message read markers, you
  4840.                might want to use this option to reset them to what you want.
  4841.  
  4842.                You can set individual conferences one at a time, or you can
  4843.                reset all at once.
  4844.  
  4845.                When setting individual conferences, you will be prompted to
  4846.                select the type of mail you wish to extract.  Each conference
  4847.                can be configured in 1 of 3 different ways:
  4848.                
  4849.                   A)ll         - Extract all mail from this conference
  4850.                   P)ersonal    - Extract only your personal mail
  4851.                   S)ys Default - Extract based on what you told Mail Manager
  4852.                                  to do by default via option D on the
  4853.                                  Configuration menu (see below).
  4854.                
  4855.            B - Download messages in Q)WK or T)ext format
  4856.                
  4857.                Set to text if you want to use Mail Manager as a simple "extract
  4858.                and download" system (all messages in a single continuous ascii
  4859.                file).
  4860.                
  4861.                Set to QWK if you want to read and reply offline using a QWK-
  4862.                compatible mail reader.
  4863.                
  4864.                             <<< QWK NETWORK USERS >>>
  4865.                    
  4866.                    ** NOTE **  This field is different for QWK network users.
  4867.                    If you have given a user "net status" via MUSER, this gives
  4868.                    them the option of creating a "full QWK" (with all
  4869.                    accompanying files normally present within), or a minimized
  4870.                    QWK packet that contains only what is necessary for network
  4871.                    mail transfer.  The latter would save them archiving and
  4872.                    transfer time by creating a smaller packet, the former might
  4873.                    be preferred if they wish to review the packet via an
  4874.                    offline reader program, and can be useful when setting up
  4875.                    conference numbers appropriately on their end of the line.
  4876.                    
  4877.                    At any rate, they will have the option one way or the other,
  4878.                    and can change it whenever they wish.
  4879.                    
  4880.  
  4881.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 98 -
  4882.  
  4883.  
  4884.            C - Msgs addressed to ALL marked as personal (QWK only)
  4885.                
  4886.                If set to "Y", Mail Manager will add messages addressed to "ALL"
  4887.                to the user's personal index the QWK packet.
  4888.                
  4889.                
  4890.            D - Extract ONLY your personal mail as default
  4891.                
  4892.                If set to "Y", Mail Manager will not extract a message unless it
  4893.                is addressed to you.  (Will also extract msgs addressed to "ALL"
  4894.                if you have option C set to "Y".)  This is the default setting
  4895.                for the user, but it can be overridden for individual
  4896.                conferences when setting the
  4897.                conference message pointers (see main menu option M).
  4898.                
  4899.            E - Extract messages written by you
  4900.                
  4901.                If set to "NO", Mail Manager will not include messages from you
  4902.                in your packet.
  4903.                
  4904.            F - Abort packet if no new messages
  4905.                
  4906.                You might not want to do this if you would still like to receive
  4907.                new file listings or updated system news or bulletins.
  4908.                
  4909.            G - Send updated bulletins
  4910.                
  4911.                If set to "No", any updated bulletins which the sysop has
  4912.                designated as mandatory will still be included.
  4913.                
  4914.            H - Send new file listings
  4915.                
  4916.                If you select this option, a listing of newly-uploaded files
  4917.                will be included in your mail packet.
  4918.                
  4919.                This option is only operational on systems with standard RBBS
  4920.                FMS style file listings.
  4921.                
  4922.            I - Ask before sending packet
  4923.                
  4924.                If set to "Yes", will cause Mail Manager to prompt you whether
  4925.                or not you want to receive the mail packet that it just created
  4926.                for you.  Will otherwise go right into the download when
  4927.                finished extracting.
  4928.                
  4929.            J - Type of file compression to use
  4930.                
  4931.                If the Sysop has activated this option, you can choose from the
  4932.                file compression utilities offered on this system (ZIP, ARC,
  4933.                etc.).
  4934.                
  4935.  
  4936.     MAIL MANAGER +PLUS+ MENU COMMANDS                               - Page 99 -
  4937.  
  4938.  
  4939.            K - Default file transfer protocol
  4940.                
  4941.                Choose from the protocols offered by your sysop (Xmodem, Zmodem,
  4942.                etc.).  If set to N)one, Mail Manager will prompt you for which
  4943.                protocol to use at each file transfer.
  4944.            
  4945.            L - Update high message numbers after downloading
  4946.                
  4947.                If this is set to NO, both RBBS and Mail Manager will think that
  4948.                you haven't read the messages that you've downloaded. (Mail
  4949.                Manager will extract them again your next time in).
  4950.                
  4951.            M - Update high message numbers after R)eading
  4952.                
  4953.                This option will not be displayed if you have disabled the R)ead
  4954.                and P)ost options in MAILCFG.
  4955.                
  4956.                If set to NO, any messages that you read in the door will still
  4957.                be downloaded in your next mail packet.  This can be handy for
  4958.                checking a message or two before downloading your mail.
  4959.                
  4960.                If set to YES, the highest message number you read sets your
  4961.                high message marker, and only higher message numbers  will be
  4962.                included in your next mail packet.
  4963.                
  4964.            N - Max messages desired per packet/conference
  4965.                
  4966.                If set to "0", will use sysop-selected maximum for both limits.
  4967.                If user sets either beyond sysop-selected system limit, system
  4968.                limit will be used when extracting.
  4969.            T - Use 'TurboKeys' (act on 1-character commands)
  4970.                
  4971.                Works like RBBS-PC's toggle of the same name.  If set to Yes,
  4972.                Mail Manager will not wait for [ENTER] when asking you for input
  4973.                where one character responses are expected.
  4974.                
  4975.            ? - Display help file
  4976.                
  4977.                Display help file which explains the configuration options.
  4978.                
  4979.            Q - Quit (finished configuring)
  4980.                
  4981.                (Or just press [ENTER] to accomplish the same thing).
  4982.  
  4983.     APPENDIX A - COMMON PROBLEMS                                   - Page 100 -
  4984.      
  4985.  
  4986.          
  4987.          Problem :  Not finding the Sysop in any conferences.
  4988.                     
  4989.          Solution:  Double-check your setting of "Remote Sysop Name" on the
  4990.                     first screen of the MAILCFG program.  This setting must be
  4991.                     the name that you use to log onto your system remotely, NOT
  4992.                     your name as you are known to your users.
  4993.                     
  4994.          ----------------------------------------------------------------------
  4995.                     
  4996.          Problem :  Shows "Error finding new message" when trying to extract
  4997.                     your first mail packet.
  4998.                     
  4999.          Solution:  Run MAILFIX.EXE against the message base in question (using
  5000.                     the proper command line switches).  Re-read the section of
  5001.                     this document entitled "Before you begin".
  5002.                     
  5003.          ----------------------------------------------------------------------
  5004.                     
  5005.          Problem :  Always showing Sysop name when operating remotely.
  5006.                     
  5007.          Solution:  Probably not copying the correct DORINFOx.DEF file to the
  5008.                     Mail Manager directory prior to loading the door.  Drop to
  5009.                     DOS, and take a look at the DORINFOx.DEF that was in use at
  5010.                     the time.
  5011.                     
  5012.                     Also possible that the door is coming up in local mode.
  5013.                     Check your DOORS.DEF and MAILMGR.BAT files to be sure they
  5014.                     are set correctly.  Mail Manager should be called (as a
  5015.                     minimum) like so:
  5016.                     
  5017.                         MAILMGR %1
  5018.                     
  5019.                     (Where %1 is the node number).  If you suspect that the
  5020.                     node number is NOT being passed correctly, turn ECHO ON at
  5021.                     the top of your batch file and watch what it actually
  5022.                     passes to the door.
  5023.                     
  5024.          ----------------------------------------------------------------------
  5025.                     
  5026.          Problem :  Always using locked BPS rate for download estimates,
  5027.                     instead of true connect rate.
  5028.                     
  5029.          Solution:  No fix if you are running stock RBBS-PC v17.3C and lower.
  5030.                     You must upgrade to RBBS-PC v17.4 to get this figure
  5031.                     reported correctly, or recompile RBBS-PC with the CBAUD
  5032.                     merge.
  5033.                     
  5034.                     If you are running RBBS-PC v17.4 and above, change your
  5035.                     DOORS.DEF line to read something like:
  5036.                     
  5037.                        MAILMGR,5,,D,"C:\MAILMGR.BAT [NODE] [CBAUD]",N,,
  5038.                     
  5039.                     Then, in MAILMGR.BAT, change the line that calls Mail
  5040.                     Manager to read:  MAILMGR %1 /CBAUD%2
  5041.  
  5042.     APPENDIX A - COMMON PROBLEMS                                   - Page 101 -
  5043.      
  5044.  
  5045.                     
  5046.          ----------------------------------------------------------------------
  5047.                     
  5048.          Problem :  Not allowing REP uploads to a particular conference, with
  5049.                     the error message "Message base full".
  5050.                     
  5051.          Solution:  Make 100% sure that both RBBS-PC and Mail Manager +Plus+
  5052.                     are configured to the exact same type of message base.  For
  5053.                     instance, if RBBS-PC is configured to have message base
  5054.                     "grow" as messages are added, yet that conference is
  5055.                     configured in Mail Manager +Plus+ as fixed length, this
  5056.                     type of error will appear EVERY time a message is uploaded
  5057.                     for that conference.
  5058.                     
  5059.                     If all appears to be sound, and that error message still
  5060.                     appears, try running MAILFIX.EXE against the offending
  5061.                     message base.
  5062.                     
  5063.          ----------------------------------------------------------------------
  5064.                     
  5065.          Problem :  Program gives error message "Unable to pack...", after
  5066.                     trying to compress a mail packet.
  5067.                     
  5068.          Solution:  We have heard this one before, (and have run into it
  5069.                     ourselves), and it has always been one of three things:
  5070.                     
  5071.                     - Your file compression program was not where the list of
  5072.                        archivers said it was (MAILMGR.ARL), or
  5073.                     
  5074.                     - There was insufficient memory to run the archiver, or
  5075.                     
  5076.                     - There was insufficient disk space to archive the mail
  5077.                       packet for the user.  (A 1,000-message packet can be over
  5078.                       1 meg in size before compression).
  5079.                     
  5080.                     Read the section of this document entitled "CHECKLIST OF
  5081.                     REQUIREMENTS" for Mail Manager +Plus+ memory requirements.
  5082.                     
  5083.          ----------------------------------------------------------------------
  5084.                     
  5085.          Problem :  Program gives errors while extracting mail from a FIDO
  5086.                     *.MSG area, and/or has problems when updating last message
  5087.                     read in a FIDO area after a download.
  5088.                     
  5089.          Solution:  More than likely, Mail Manager +Plus+ experienced an error
  5090.                     with the index file for that FIDO area that it wasn't able
  5091.                     to recover from.  Try running the MMINDEX.EXE program, and
  5092.                     insure that MMINDEX is in your nightly event as the LAST
  5093.                     thing before your BBS comes back up.
  5094.                     
  5095.          ----------------------------------------------------------------------
  5096.          
  5097.  
  5098.     APPENDIX A - COMMON PROBLEMS                                   - Page 102 -
  5099.      
  5100.  
  5101.          Problem :  Local screen looks fine, but the caller on the remote end
  5102.                     of the line has incomplete and partially garbled screens.
  5103.                     
  5104.          Solution:  If your communications port is locked higher than the
  5105.                     user's true connect speed (typically 19200 or 38400 for
  5106.                     today's fast modems), Mail Manager +Plus+ is probably
  5107.                     overrunning the communications buffer.  You can get around
  5108.                     this problem by installing a FOSSIL driver such as BNU or
  5109.                     X00 (available on bulletin boards all over the place), and
  5110.                     telling Mail Manager +Plus+ to always use the FOSSIL for
  5111.                     flow control.  Set the flow control option (in the MAILCFG
  5112.                     program) to "F".
  5113.                     
  5114.                     See the section of this document entitled "IF YOU HAVE A
  5115.                     LOCKED BPS RATE" for more information on this subject.
  5116.                     
  5117.          ---------------------------------------------------------------------
  5118.                     
  5119.          Problem :  Mail Manager +Plus+ is not finding some of the files as set
  5120.                     in the configuration file, or always seems to be using
  5121.                     defaults instead of the options that you have custom-
  5122.                     configured.
  5123.          
  5124.          Solution:  The most likely cause of this problem is an incomplete (or
  5125.                     incorrect) drive:\path\file designation for a key file or
  5126.                     two in the configuration program.  In particular - DO NOT
  5127.                     simply use a "drive:filename.ext" designation to tell Mail
  5128.                     Manager +Plus+ where to look.  Mail Manager +Plus+ always
  5129.                     operates out of a work directory, and is never going to be
  5130.                     in the \MAILMGR directory when it looks for its files.  For
  5131.                     example:
  5132.                     
  5133.                         D:MAILMGR.PRO
  5134.                     
  5135.                     may not work, but:
  5136.                     
  5137.                         D:\MAILMGR\MAILMGR.PRO
  5138.                     
  5139.                     might.
  5140.          
  5141.          ---------------------------------------------------------------------
  5142.                     
  5143.          Problem :  After an RBBS message base has been renumbered, Mail
  5144.                     Manager +Plus+ doesn't find new messages until the user
  5145.                     manually resets his last-message-read (LMR) pointer.
  5146.          
  5147.          Solution:  Mail Manager reads the LMR pointer from the user's record
  5148.                     in the RBBS user file for that conference (xxxxU.DEF).
  5149.                     The utility you use to renumber the message base must also
  5150.                     update the LMR pointers in the user file in order for Mail
  5151.                     Manager (or RBBS for that matter) to find new messages.  If
  5152.                     the renumbering utility you are using does not do this,
  5153.                     consider using our MAILFIX utility to renumber your base,
  5154.                     or the renumber facility built into RBBS' CONFIG utility
  5155.                     (17.4 or higher) - both of these will update the user LMR
  5156.  
  5157.     APPENDIX A - COMMON PROBLEMS                                   - Page 103 -
  5158.      
  5159.  
  5160.                     pointers when they renumber an RBBS message base.
  5161.          
  5162.          ---------------------------------------------------------------------
  5163.                     
  5164.          Problem :  Mail Manager works fine for nodes 1-9 but higher nodes will
  5165.                     not load.
  5166.          
  5167.          Solution:  If you are using a door control file (normally called
  5168.                     DOORS.DEF, but you may have named it something else in your
  5169.                     RBBS configuration), RBBS passes the node number via the
  5170.                     [NODE] variable.  Apparently, when processing DOORS.DEF,
  5171.                     RBBS passes the nodes above 9 as "10", "11", etc., rather
  5172.                     than the one-character node designations "0", "A", "B",
  5173.                     etc. which MAILMGR needs.  The solution is to set a NODE
  5174.                     variable containing the one-character node designation in
  5175.                     your dos environment in the batch file you use to load each
  5176.                     RBBS node (you're probably doing this already).  Then pass
  5177.                     that to MAILMGR as follows:
  5178.                     
  5179.                     In DOORS.DEF, don't pass [NODE] at all.  An example line
  5180.                     would be:
  5181.                     
  5182.                           MAILMGR,5,,D,"C:\MAILMGR.BAT [CBAUD]",N,,
  5183.                     
  5184.                     In your MAILMGR.BAT file, change the line which actually
  5185.                     loads the door to:
  5186.                     
  5187.                           MAILMGR %NODE% /CBAUD%1
  5188.          
  5189.          ---------------------------------------------------------------------
  5190.          
  5191.          Problem :  Program gives error message to the effect of "Reply file
  5192.                     not found after upload".
  5193.          
  5194.          Solution:  One of two things:  Either the user did not upload a valid
  5195.                     REP packet, or you have an invalid unpacker configured.
  5196.                     For example, if you have PKUNZIP v1.10 in your DOS path,
  5197.                     yet your user uploads a REP packet created with PKZIP
  5198.                     v2.04g, this type of error will occur.
  5199.  
  5200.     APPENDIX B - CONTACTING THE AUTHORS                            - Page 104 -
  5201.  
  5202.  
  5203.  
  5204.          Due to the transitory nature of many bulletin boards, and the fact
  5205.          that you may be reading these instructions a long time after they are
  5206.          written, it is probably best not to list bulletin boards where we may
  5207.          be reached.  Inevitably, whichever board we cite will immediately go
  5208.          out of business, and the phone number will be reassigned to somebody
  5209.          who does not care to be awakened by the phone ringing in the middle of
  5210.          the night when we modem junkies place most of our long distance calls.
  5211.          
  5212.          The authors, however, CAN be found on the following computer network
  5213.          conferences:
  5214.                                   Fido: RBBS-PC and OFFLINE
  5215.                                   Rime: RBBS-PC and RBBSQWK
  5216.          
  5217.          New releases are always announced in these conferences, and we
  5218.          occasionally post lists of the currently active distribution sites
  5219.          there.  If you wish to contact us via these conferences, address
  5220.          messages to Doug Wilson or Chip Morrow.
  5221.          
  5222.          Current Makai Software releases are always sent to Compuserve within a
  5223.          few days of release, in the IBMBBS forum (GO IBMBBS).  The doors
  5224.          themselves may be found in library 3, while the individually-
  5225.          distributed utilities (MNET, MAILFIX, etc.) may be found in library 2.
  5226.          While you're on Compuserve, you can reach one of the authors, Chip
  5227.          Morrow, there (72677,502).
  5228.  
  5229.          Chip Morrow is also available via Prodigy and Internet, if either of
  5230.          those are more convenient:
  5231.  
  5232.                               Prodigy:  GVHM95A
  5233.                              Internet:  72677.502@compuserve.com
  5234.  
  5235.          And if all else fails, there's always good ol' U.S. Mail (see
  5236.          REGISTER.DOC):
  5237.  
  5238.                              Makai Software
  5239.                              870 Golden Drive
  5240.                              Newark, OH 43055
  5241.  
  5242.          We're sorry, but we simply do not have the time or resources to make 
  5243.          individual voice calls to help with debugging your MAILMGR setup.  On
  5244.          the other hand, we'd like to see you in any of the above network
  5245.          conferences, where you can get help from others as well as ourselves, 
  5246.          and where questions/answers/reports/release notices get a much wider 
  5247.          audience, and can benefit more people.  
  5248.  
  5249.     APPENDIX C - ACKNOWLEDGEMENTS                                  - Page 105 -
  5250.  
  5251.  
  5252.          Microsoft, Crescent Software, DSZ, PKZIP, LHARC, ARJ, LZEXE, PKLITE,
  5253.          JIMMER, TQM, SILVER EXPRESS, LANtastic, DESQview, BNU, X00, RBBSMAIL,
  5254.          MSGTOSS, OVERMAIL, PDQ, PDQCOMM, QuickBASIC, RBBS-PC, SLMR, JABBER,
  5255.          OFFLINE, OLX, RNET, TNET, and SHROOM (did we miss any?) are all
  5256.          trademarks or tradenames of their respective authors and/or companies,
  5257.          and are mentioned throughout our documentation for clarity only.
  5258.          
  5259.          Our Special thanks go to everyone who supported us through development
  5260.          of the Mail Manager package.  Many of the names have faded, some have
  5261.          gone on to other BBS's and/or other doors, others have grown silent
  5262.          over the last few years, others continue to provide us with
  5263.          suggestions to this day.  Without your support, the door would never
  5264.          be where it is today.  Some names of special note:
  5265.          
  5266.             Michael Lurie, who has supported the door (and its continued
  5267.             development) since day one.
  5268.             
  5269.             Dave Brodmann, who was severely abused by early beta versions of
  5270.             Mail Manager +Plus+, and has goodnaturedly put up with our
  5271.             harebrained schemes ever since.  Dave's help was invaluable in
  5272.             taking "Plus" beyond 250 conference limits.
  5273.             
  5274.             The trio of Rod Bowman, Don Smith, and Joe Tailleur who beta tested
  5275.             the first versions to support FIDO *.MSG's and helped solve a lot
  5276.             of early problems before Mail Manager +Plus+ hit the streets.
  5277.             
  5278.             Kip Gies, who tested a late beta of v2.03 and helped us get the
  5279.             initial bugs out of the FIDO *.MSG handling.
  5280.             
  5281.             Eddie Rowe, who tested the last betas of pre-v3.x code, helped us
  5282.             get some last-minute bugs out of the new code, found the "old
  5283.             format" problem in outbound mail packets created by v2.x, and
  5284.             provided us with updated Fido format documentation.
  5285.             
  5286.             Marion Royal, who ran our QWK network implementation through the
  5287.             wringer, picked MNET and MUSER apart <g>, and provided us with
  5288.             sufficient information to implement QWK network capability.  There
  5289.             would be no QWK networking in this door without Marion's efforts.
  5290.             
  5291.             Paul Di Novo, who verified that the door really could work in a
  5292.             non-RBBS-PC environment, and provided us with useful information
  5293.             for future compatibility issues.
  5294.             
  5295.             Rick Moen, who worked through many versions of QWK-networking and
  5296.             handling of tear and taglines before we finally hit on the right
  5297.             combination.  Rick's long distance carrier thanks him too.
  5298.             
  5299.             Richie Molinelli, who provided the modified time slice giveback
  5300.             routines for implementing this feature under OS/2.
  5301.             
  5302.          And thanks to everyone else who commented and offered suggestions,
  5303.          help, and beta testing.  We honestly cannot remember all of the names,
  5304.          and do apologize for that!
  5305.          
  5306.  
  5307.     APPENDIX D - MAIL MANAGER'S FILE FORMATS                       - Page 106 -
  5308.  
  5309.  
  5310.          Just in case someone out there has an inkling to write a utility
  5311.          program or two for use with their Mail Manager +Plus+ setup, here are
  5312.          the formats for the Mail Manager +Plus+ v3.51 binary system files,
  5313.          MAILMGR.CFG and MAILMGR.USR.
  5314.          
  5315.          +--------------------------------------------------------------------+
  5316.          | MAILMGR.USR - Mail Manager's internal users file.                  |
  5317.          |               One 570-byte record per user.  Each 570-byte record  |
  5318.          |               broken down as follows:                              |
  5319.          |--------------------------------------------------------------------|
  5320.          | Start Stop Length Record Type Description                          |
  5321.          |====================================================================|
  5322.          |     1   31     31    STRING   The user's name, in upper case,      |
  5323.          |                               left-justified, padded with ASCII 32s|
  5324.          |--------------------------------------------------------------------|
  5325.          |    32  531    500    STRING   Bit-mapped conference flags for each |
  5326.          |                               user, 1 byte per conference.  If bit |
  5327.          |                               is set to 1 it means:                |
  5328.          |                                Bit: 0 = conf active                |
  5329.          |                                     1 = accept default msg select. |
  5330.          |                                     2 = if bit 1 not set, pers only|
  5331.          |                                     3 = conf net status granted    |
  5332.          |                                     4 = if bit 3 set, net access to|
  5333.          |                                         private messages.          |
  5334.          |                                 5,6,7 = reserved                   |
  5335.          |--------------------------------------------------------------------|
  5336.          |   532  532      1    STRING   User's QWK preference.  Either "Q"   |
  5337.          |                               or "T".  (QWK or TEXT).              |
  5338.          |--------------------------------------------------------------------|
  5339.          |   533  533      1    STRING   User's flag for whether or not to    |
  5340.          |                               update last message read in the RBBS |
  5341.          |                               user files (after downloading pkts). |
  5342.          |                               ASCII 1 for true, 255 for false.     |
  5343.          |--------------------------------------------------------------------|
  5344.          |   534  534      1    STRING   Letter of the user's default file    |
  5345.          |                               protocol choice, in upper case.      |
  5346.          |--------------------------------------------------------------------|
  5347.          |   535  535      1    STRING   Messages addressed to "ALL" marked   |
  5348.          |                               as personal in QWK packet?  ASCII 1  |
  5349.          |                               for true, 255 for false.             |
  5350.          |--------------------------------------------------------------------|
  5351.          |   536  536      1    STRING   Xpert toggle on or off (ASCII 1, 255)|
  5352.          |--------------------------------------------------------------------|
  5353.          |   537  537      1    STRING   Bit flag byte for other user options.|
  5354.          |                                          Bit:  0 = Send own msgs   |
  5355.          |                                                1 = Send bullets    |
  5356.          |                                                2 = Send newfiles   |
  5357.          |                                                3 = Abort if no msgs|
  5358.          |                                                4 = Ask before send |
  5359.          |                                                5 = Only pers mail  |
  5360.          |                                                6 = Turbokey toggle |
  5361.          |--------------------------------------------------------------------|
  5362.          |   538  540      3    STRING   User's choice of archiver (ZIP, ARC, |
  5363.          |                               etc.)                                |
  5364.          |--------------------------------------------------------------------|
  5365.  
  5366.     APPENDIX D - MAIL MANAGER'S FILE FORMATS                       - Page 107 -
  5367.  
  5368.  
  5369.          |   541  546      6    STRING   "YYMMDD" that user last used the     |
  5370.          |                               door. ("911223" = 23 Dec 91)         |
  5371.          |--------------------------------------------------------------------|
  5372.          |   547  547      1    STRING   Net status CHR$(0=none,1=node,2=host)|
  5373.          |--------------------------------------------------------------------|
  5374.          |   548  555      8    STRING   Packet name for net status user      |
  5375.          |--------------------------------------------------------------------|
  5376.          |   556  559      4      LONG   Date/Time of last REP packet         |
  5377.          |--------------------------------------------------------------------|
  5378.          |   560  563      4      LONG   FileSize of last REP packet          |
  5379.          |--------------------------------------------------------------------|
  5380.          |   564  564      1    STRING   Update last read after reading online|
  5381.          |                               CHR$(1) = true, 255 = false.         |
  5382.          |--------------------------------------------------------------------|
  5383.          |   565  566      2   INTEGER   User's choice of max msgs / packet.  |
  5384.          |--------------------------------------------------------------------|
  5385.          |   567  568      2   INTEGER   User's choice of max msgs / conf.    |
  5386.          |--------------------------------------------------------------------|
  5387.          |   569  570      2    STRING   Reserved for future use.             |
  5388.          +--------------------------------------------------------------------+
  5389.          
  5390.          +--------------------------------------------------------------------+
  5391.          | MAILMGR.CFG- Mail Manager's configuration file.                    |
  5392.          |              Consists of one 556-byte header, followed by a number |
  5393.          |              of 384-byte conference configuration records.         |
  5394.          |                                                                    |
  5395.          |                          HEADER RECORD:                            |
  5396.          |--------------------------------------------------------------------|
  5397.          | Start Stop Length Record Type Description                          |
  5398.          |====================================================================|
  5399.          |     1   35     35   STRING    Name of the BBS (in proper case).    |
  5400.          |--------------------------------------------------------------------|
  5401.          |    36   66     31   STRING    Remote logon name of the sysop (left-|
  5402.          |                               justified, in upper case, padded with|
  5403.          |                               ASCII 32 blanks).                    |
  5404.          |--------------------------------------------------------------------|
  5405.          |    67   81     15   STRING    Sysop's public first name.           |
  5406.          |--------------------------------------------------------------------|
  5407.          |    82   96     15   STRING    Sysop's public last name.            |
  5408.          |--------------------------------------------------------------------|
  5409.          |    97   98      2  INTEGER    Security level to read ALL messages. |
  5410.          |--------------------------------------------------------------------|
  5411.          |    99  100      2  INTEGER    Security level to use in local mode. |
  5412.          |--------------------------------------------------------------------|
  5413.          |   101  102      2  INTEGER    Local sysop's graphic preference.    |
  5414.          |                               2 = ANSI, 1 = ASCII, 0 = None.       |
  5415.          |--------------------------------------------------------------------|
  5416.          |   103  163     61   STRING    Default tagline for all conferences. |
  5417.          |--------------------------------------------------------------------|
  5418.          |   164  165      2  INTEGER    Number of 334-byte conference        |
  5419.          |                               configuration records that follow    |
  5420.          |                               this header record.                  |
  5421.          |--------------------------------------------------------------------|
  5422.  
  5423.     APPENDIX D - MAIL MANAGER'S FILE FORMATS                       - Page 108 -
  5424.  
  5425.  
  5426.          |   166  173      8   STRING    First 8 characters of extract file   |
  5427.          |                               name to use (this is the "*" of      |
  5428.          |                               *.QWK, *.REP, *.ZIP, etc.).          |
  5429.          |--------------------------------------------------------------------|
  5430.          |   174  176      3   STRING    3 upper case characters designating  |
  5431.          |                               the default file compression type    |
  5432.          |                               (ZIP, ARC, ARJ, or LZH)              |
  5433.          |--------------------------------------------------------------------|
  5434.          |   177  216     40   STRING    Full path/filename of the NEWS file. |
  5435.          |--------------------------------------------------------------------|
  5436.          |   217  256     40   STRING    Full path/filename of the list of    |
  5437.          |                               bulletins (MAILMGR.BUL).             |
  5438.          |--------------------------------------------------------------------|
  5439.          |   257  257      1   STRING    Network type to use in local mode.   |
  5440.          |                               D)os, N)etbios, desQ)view.           |
  5441.          |--------------------------------------------------------------------|
  5442.          |   258  258      1   STRING    Handshake method to use, upper case. |
  5443.          |                               R)ts, X)on, N)one, or F)ossil.       |
  5444.          |--------------------------------------------------------------------|
  5445.          |   259  260      2  INTEGER    Version number (3.50 = 350).         |
  5446.          |--------------------------------------------------------------------|
  5447.          |   261  300     40   STRING    Path/filename of MAILMGR.PRO         |
  5448.          |--------------------------------------------------------------------|
  5449.          |   301  340     40   STRING    Path/filename of FMS directory.      |
  5450.          |--------------------------------------------------------------------|
  5451.          |   341  380     40   STRING    Path/name of list of archivers.      |
  5452.          |--------------------------------------------------------------------|
  5453.          |   381  395     15   STRING    Name of environment variable to      |
  5454.          |                               path/name of XFER-x.DEF log file.    |
  5455.          |--------------------------------------------------------------------|
  5456.          |   396  396      1   STRING    Modify uploaded messages date & time |
  5457.          |                               stamp to the current system time?    |
  5458.          |                               (Y or N)                             |
  5459.          |--------------------------------------------------------------------|
  5460.          |   397   427     31  STRING    City/State where BBS is located.     |
  5461.          |--------------------------------------------------------------------|
  5462.          |   428   439     12  STRING    Phone number of BBS. "xxx-xxx-xxxx"  |
  5463.          |--------------------------------------------------------------------|
  5464.          |   440   440      1  STRING    SmartText ID character               |
  5465.          |--------------------------------------------------------------------|
  5466.          |   441   480     40  STRING    Default path to *M.DEF conferences.  |
  5467.          |--------------------------------------------------------------------|
  5468.          |   481   520     40  STRING    Path/name of echo toss log.          |
  5469.          |--------------------------------------------------------------------|
  5470.          |   521   525      5  STRING    Start of timelock (HH:MM).           |
  5471.          |--------------------------------------------------------------------|
  5472.          |   526   530      5  STRING    End of timelock (HH:MM) - 24 hour    |
  5473.          |                               format for both of these.            |
  5474.          |--------------------------------------------------------------------|
  5475.          |   531   531      1  STRING    Drop DTR on G)oodbye/E)xpedite? (Y/N)|
  5476.          |--------------------------------------------------------------------|
  5477.          |   532   532      1  STRING    Show empty/unjoinable confs? (Y/N)   |
  5478.          |--------------------------------------------------------------------|
  5479.          |   533   534      2 INTEGER    Max msgs allowed per packet          |
  5480.          |--------------------------------------------------------------------|
  5481.  
  5482.     APPENDIX D - MAIL MANAGER'S FILE FORMATS                       - Page 109 -
  5483.  
  5484.  
  5485.          |   535   535      1 STRING     Make conference receiving violaton   |
  5486.          |                               notices mandatory (Y/N)              |
  5487.          |--------------------------------------------------------------------|
  5488.          |   536   536      1 STRING     Allow online R)ead, P)ost (Y/N)      |
  5489.          |--------------------------------------------------------------------|
  5490.          |   537   556     20  STRING    Reserved for future use.             |
  5491.          +--------------------------------------------------------------------+
  5492.          
  5493.          +--------------------------------------------------------------------+
  5494.          |                   CONFERENCE CONFIGURATION RECORD:                 |
  5495.          |--------------------------------------------------------------------|
  5496.          | Start Stop Length Record Type Description                          |
  5497.          |====================================================================|
  5498.          |     1    7      7   STRING    Name of the conference, upper case.  |
  5499.          |--------------------------------------------------------------------|
  5500.          |     8    8      1   STRING    # of lines per msg (CHR$ byte value  |
  5501.          |                               plus 32).  CHR$(131) = 99 lines per  |
  5502.          |                               message.  CHR(0) = do not split long |
  5503.          |                               messages.                            |
  5504.          |--------------------------------------------------------------------|
  5505.          |     9   10      2  INTEGER    Point ID for Fido *.MSG areas.       |
  5506.          |--------------------------------------------------------------------|
  5507.          |    11   12      2  INTEGER    "Fakenet" ID for 2D Fido points.     |
  5508.          |--------------------------------------------------------------------|
  5509.          |    13   25     14   STRING    Reserved for future use.             |
  5510.          |--------------------------------------------------------------------|
  5511.          |    26  105     80   STRING    Path/name to USERS file.             |
  5512.          |--------------------------------------------------------------------|
  5513.          |   106  185     80   STRING    Path/name to MESSAGES file.          |
  5514.          |--------------------------------------------------------------------|
  5515.          |   186  186      1   STRING    Allow ANSI in REPs?  (Y, N)          |
  5516.          |--------------------------------------------------------------------|
  5517.          |   187  187      1   STRING    Allow high/low ASCII in REPs? (Y, N) |
  5518.          |--------------------------------------------------------------------|
  5519.          |   188  189      2  INTEGER    Security level needed to join.       |
  5520.          |--------------------------------------------------------------------|
  5521.          |   190  191      2  INTEGER    Security level needed to post.       |
  5522.          |--------------------------------------------------------------------|
  5523.          |   192  252     61   STRING    Tagline for this conference.         |
  5524.          |--------------------------------------------------------------------|
  5525.          |   253  253      1   STRING    Fido-style tearlines?  (Y, N)        |
  5526.          |--------------------------------------------------------------------|
  5527.          |   254  254      1   STRING    Type of message base? (Y, N, F)      |
  5528.          |--------------------------------------------------------------------|
  5529.          |   255  255      1   STRING    Allow join within door? (Y, N)       |
  5530.          |--------------------------------------------------------------------|
  5531.          |   256  335     80   STRING    Path/Name of conf alias file.        |
  5532.          |--------------------------------------------------------------------|
  5533.          |   336  337      2  INTEGER    Zone ID (for FIDO areas)             |
  5534.          |--------------------------------------------------------------------|
  5535.          |   338  339      2  INTEGER    Net ID  (for FIDO areas)             |
  5536.          |--------------------------------------------------------------------|
  5537.          |   340  341      2  INTEGER    Node ID (for FIDO areas)             |
  5538.          |--------------------------------------------------------------------|
  5539.          |   342  342      1   STRING    Netmail area?  (Y, N).               |
  5540.  
  5541.     APPENDIX D - MAIL MANAGER'S FILE FORMATS                       - Page 110 -
  5542.  
  5543.  
  5544.          |--------------------------------------------------------------------|
  5545.          |   343  343      1   STRING    Add tear/tag to end of FIDO msg?(Y,N)|
  5546.          |--------------------------------------------------------------------|
  5547.          |   344  358     15   STRING    Symbolic area name for this FIDO     |
  5548.          |                               conference. (Optional)               |
  5549.          |--------------------------------------------------------------------|
  5550.          |   359  359      1   STRING    Allow uploaded messages to be marked |
  5551.          |                               as private in this conf?  (Y, N)     |
  5552.          |--------------------------------------------------------------------|
  5553.          |   360  384     25   STRING    Long Description of the conference.  |
  5554.          +--------------------------------------------------------------------+
  5555.  
  5556.     APPENDIX E - ABOUT THIS DOCUMENT                               - Page 111 -
  5557.  
  5558.          Programmers have long been known to be terrible about writing
  5559.          documentation to cover their own software, and we are probably not
  5560.          going to disprove this theory with the opus you are reading now.
  5561.  
  5562.          After two years of threatening to do so, we have finally taken the
  5563.          rambling mess which spewed out of a couple of different text editors
  5564.          (the same ones we used to do the program coding) and shoved it all
  5565.          into an actual-by-gum word processor <gasp> to try to get more
  5566.          consistency of formatting, automatic page numbering, etc.
  5567.          
  5568.          But the basic text is what you have all come to love (?) in previous
  5569.          releases.  This means that there are two constants:
  5570.          
  5571.          - It SHOULD print out just fine on standard tractor-fed 8 1/2 x 11
  5572.          paper on your garden-variety dot-matrix printer.  We have attempted to
  5573.          limit page length to 60 lines, to allow it to be printed on 60-line-
  5574.          per-page laser printers.
  5575.          
  5576.          - It is practically guaranteed to contain spelling and grammar errors.
  5577.          
  5578.          This thing is probably too long by half, but every time we try to cut
  5579.          it down, we end up adding more than we cut (sounds sort of like
  5580.          Congress trying to trim the Federal Budget...)
  5581.          
  5582.          
  5583.                     Sincere Best Wishes to Each of You,
  5584.          
  5585.                     Doug Wilson and Chip Morrow
  5586.  
  5587.