home *** CD-ROM | disk | FTP | other *** search
/ Monster Disc 2: The Best of 1992 / MONSTER1.ISO / bbs / rbbs / rmail182.zip / RBBSMAIL.DOC < prev    next >
Text File  |  1992-09-17  |  133KB  |  3,457 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                       RBBSMail, the RBBS-PC Echomail Processor
  15.                                                                   Version 18.2
  16.                                       Featuring CRITMON<tm> and DynaPurge<TM>!
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                                        (C) by Jan R.  Terpstra
  26.  
  27.  
  28.                                                             September 17, 1992
  29.  
  30.  
  31.                                                                  Bamestra RBBS
  32.                                                                     P.O.Box 66
  33.                                                              1462 ZH  Beemster
  34.                                                                The Netherlands
  35.                                                              RBBSNet 8:998/1.0
  36.                                                             FIDONET 2:512/10.0
  37.                                                    phone1 ++31 2998 3602 (v24)
  38.                                                    phone2 ++31 2998 3603 (HST)
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                                      Document Number RM_920917
  48.  
  49.  
  50.  
  51.                                                                 RBBSMail v18.2
  52.     NOTICE: This is NOT a drop-in replacement of  RBBSMAIL.EXE,  you  need  to
  53.     change the configuration and batch files before running  this  version  of
  54.     RBBSMail!!!!!!!
  55.  
  56.  
  57.  
  58.                                  RBBSMail v18.2
  59.  
  60.  
  61.     1. WARNING!
  62.  
  63.  
  64.     Please note that RBBSMail v18.x is *NOT* a drop-in replacement for earlier
  65.     versions of  RBBSMail.   Several  configuration  phrases  and  commandline
  66.     switches have changed.  You *MUST* make changes  to  RBBSMAIL.CFG  and  to
  67.     your batchfiles before invoking RBBSMail to prevent sending  out  messages
  68.     that may not confirm to current FIDONET echomail distribution standards.
  69.  
  70.     What  you  should  do  before  installing  and  running  this  version  of
  71.     RBBSMail.
  72.  
  73.     ■   Delete all .EID files from your  system.   RBBSMail  v18  uses  a  new
  74.         method of checking for duplicates.
  75.     ■   In the directory where you run RBBSMail, type the command
  76.         ATTRIB RBBSMAIL.NUM -S -H (DOS 5.0) and delete the file RBBSMAIL.NUM.
  77.     ■   Read this document and make the required changes to your  RBBSMAIL.CFG
  78.         and AREA.BBS files.
  79.     ■   Note that the commandline switches of RBBSMail have changed.   Earlier
  80.         versions used a colon ":" as command delimiter.  RBBSMail v18  uses  a
  81.         space between commandline switch and parameter.
  82.     ■   Type RBBSMAIL with the appropriate commandline switches and cross  you
  83.         fingers.
  84.  
  85.  
  86.     Note: This version of RBBSMail DOES support the  CC:  feature  of  RBBS-PC
  87.     v17.4 and later.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.     WARNING!                                                                 1
  118.  
  119.  
  120.  
  121.                                  RBBSMail v18.2
  122.  
  123.  
  124.     2. What is RBBSMail
  125.  
  126.  
  127.     RBBSMail is a program that allows sysops of  RBBS-PC  bulletin  boards  to
  128.     hook their bulletin board into the international FIDONET  and  participate
  129.     in Echomail.  The combination  RBBS-PC  +  RBBSMail  +  any  of  the  mail
  130.     frontends will process messages entered in designated conferences  of  the
  131.     RBBS-PC system and  send  those  messages  to  any  other  system  in  the
  132.     FIDONET.  It will put received Echomail in  the  proper  RBBS-PC  MESSAGES
  133.     file or in to FIDO style message subdirectory.
  134.  
  135.     This way, RBBS-PC conferences can be shared  among  multiple  RBBS-PC  and
  136.     other systems in the FIDONET.  Messages entered on  any  of  the  bulletin
  137.     boards in an Echomail net will eventually be copied over to all the  other
  138.     bulletin board  systems  connected  to  the  net.   RBBSMail  does  handle
  139.     reception of directly addressed FIDONET  messages  but  it  cannot  handle
  140.     explicitly addressed messages from users on  your  system  simply  because
  141.     RBBS-PC does not (yet??) provide a way  of  addressing  network  messages.
  142.     RBBSMail can only process Echomail.
  143.  
  144.     To accomodate bulletin board systems that run another BBS program next  to
  145.     RBBS-PC, RBBSMail can also do Import and Export functions  on  FIDO  style
  146.     message subdirectories, just like ConfMail, QM  and  Dutchie's  Conference
  147.     manager do.  This allows a mixed environment where both RBBS-PC and a FIDO
  148.     compatible BBS program can participate in Echomail on a single computer.
  149.  
  150.  
  151.     2.1  Software Requirements
  152.  
  153.  
  154.     To run RBBSMail, you need (of course) a  working  RBBS-PC  based  bulletin
  155.     board with a version of RBBS-PC that  will  run  with  a  frontend  mailer
  156.     (RBBS-PC v16.1A or later), RBBSMail and suitable  batch  files.   RBBSMail
  157.     can handle RBBS-PC MESSAGES files produced by RBBS-PC v16.1A and higher.
  158.  
  159.     RBBSMail will work happily with any FTS-0001 compatible front-end  mailer,
  160.     like BinkleyTerm, FrontDoor, Dutchie or SEAdog.  All programs have  strong
  161.     and weak points, it is up to you to decide which one to use.
  162.  
  163.     BinkleyTerm is distributed including the C sourcecode, just like  RBBS-PC.
  164.     This makes the two programs "live with the same spirit".  The  combination
  165.     of BinkleyTerm, RBBSMail and the  FIDO  compatible  message  editor  MsgEd
  166.     (sourcecode also available) is my personal preference.
  167.  
  168.     Dutchie is a FIDO compatible mailer of  Dutch  origin  (hence  the  name).
  169.     Dutchie's older version came with excellent  documentation,  containing  a
  170.     very educational section on FIDONET basics.   Sadly  enough,  the  current
  171.     level of Dutchie's documentation is "less usefull" (pun intended).
  172.  
  173.     FrontDoor is a commercial FIDO compatible mailer of good quality.  It  has
  174.     a been a stable product for quite some time and exploits some  interesting
  175.     extras.
  176.  
  177.     SEAdog was the first commercial FIDONET compatible mailer.   While  a  bit
  178.  
  179.  
  180.     What is RBBSMail                                                         2
  181.  
  182.  
  183.  
  184.                                  RBBSMail v18.2
  185.  
  186.  
  187.     limited in functionality, it has been a reliable and stable product for  a
  188.     long time.
  189.  
  190.     D'Bridge is a  commercial  FIDONET  mailer  including  echomail  handling,
  191.     message editor, maintenance and  a  handful  of  other  utilities.   While
  192.     D'Bridge looks like a nice package at first glance,  it  has  had  a  long
  193.     lasting history of being bug-infested,  badly  supported  and  not  really
  194.     compliant with current FIDONET standards.
  195.  
  196.     When using all of RBBSMail's ARCmail abilities, you must  have  copies  of
  197.     the programs ARCA.COM, ARJ.EXE, PAK.EXE, LHA.EXE, PKZIP.EXE,  PKUNZIP.EXE,
  198.     ZOO.EXE  and  GUS.EXE,  either  in  the  current  subdirectory  or  in   a
  199.     subdirectory listed in your DOS PATH environment variable.
  200.  
  201.  
  202.     2.2  Hardware Requirements
  203.  
  204.  
  205.     The minimum hardware requirements to run RBBSMail are the  same  as  those
  206.     for RBBS-PC (think about that for a while....)
  207.  
  208.  
  209.     2.3  Limitations.
  210.  
  211.  
  212.     I hate to leave people out in the blue as to what they can and  cannot  do
  213.     with this program.  To  my  opinion,  if  a  program  has  limitations  or
  214.     restrictions, they should be documented.   Here  are  the  most  important
  215.     limititations of RBBSMail:
  216.  
  217.     ■   The main code and data of RBBSMail will eat about 200  KB  of  memory,
  218.         not including the compiled in-memory table of your AREAS.BBS.
  219.     ■   Depending on  the  amount  of  areas  you  carry  and  the  number  of
  220.         destination addressesper area, the compiled  table  of  AREAS.BBS  may
  221.         take 53 to 1516 bytes per individual area.
  222.     ■   The maximum line length of each line in AREAS.BBS is 1024 characters.
  223.     ■   The maximum size of processed messages is 32000 bytes.
  224.     ■   The maximum size of incoming and outgoing mailbundles is 2 Gigabyte.
  225.     ■   The maximum number of individual areas in AREAS.BBS is 512.
  226.     ■   The maximum number of destination addresses per area in  AREAS.BBS  is
  227.         50.
  228.     ■   The maximum number of messages in a RBBS-PC messages file is 999.
  229.     ■   The maximum number of messages in a FIDO .MSG  style  subdirectory  is
  230.         2048.
  231.     ■   The maximum number of net/node pairs in the SEEN-BY and PATH lines  is
  232.         256.
  233.     ■   The maximum length of any AREA: name is 64 characters.
  234.     ■   The  maximum  length   of   any   drive:\subdir\filename.ext   is   64
  235.         characters.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.     What is RBBSMail                                                         3
  244.  
  245.  
  246.  
  247.                                  RBBSMail v18.2
  248.  
  249.  
  250.     2.4  Related Documents
  251.  
  252.  
  253.     I advise you (well, it is sort of mandatory) to read or  at  least  browse
  254.     through the following documents:
  255.  
  256.     ■   The manual of the frontend mailer you are using.
  257.     ■   SD-APDX by Kim Wells (how to run SEADOG with RBBS-PC).
  258.     ■   BT-APDX by Tony Young (how to run BinkleyTerm with RBBS-PC).
  259.     ■   The Fidonet Standards Committee documents.
  260.     ■   FIDO newsletters.
  261.  
  262.     And you already read the RBBS-PC documentation, didn't you??? Or  did  you
  263.     just fire up RBBS-PC with your fingers crossed? If you are  one  of  those
  264.     who never reads documentation, you'll probably will not read  this.   But,
  265.     in case your eye accidentially catches this: Please read the documentation
  266.     before you ask any questions!!! I have had too  many  questions  asked  by
  267.     people that obviously did not read a scrap of  documentation  before  they
  268.     started what they were doing.  I have a standard answer for these  people:
  269.     R.T.F.M.!! This answer will usally solve some 95% of the  questions.   The
  270.     other 5% are 'real' problems that need some sort  of  action.   If,  after
  271.     reading  and  rereading  the  documentation  there  are  still   questions
  272.     unanswered, feel  free  to  contact  the  author  and  elaborate  on  your
  273.     problem.
  274.  
  275.  
  276.     2.5  Acknowledgements
  277.  
  278.  
  279.     It is utterly impossible to give credits were credits are  due,  but  here
  280.     are the names of some persons that have been of  great  help  and  deserve
  281.     kudos: Thom Mack, Ken Goosens and Jon Martin, authors  of  RBBS-PC.   Doug
  282.     Azzarito and Kim Wells for their many suggestions.  Jeff Rush,  author  of
  283.     TOSSMAIL and SCANMAIL, and the inventor of Echomail.   The  Binkley  Trio.
  284.     Johan Zwiekhorst for GUS and the ARCA simulator.  Bob Hartman  for  making
  285.     the  source  of  ConfMail  available.   Ron  Bemis  for  his  many  useful
  286.     suggestions and sample C code in the international NET_DEV  conference  on
  287.     FIDONET.  Mark Kimes for some refreshing ideas  and  the  wording  of  the
  288.     license agreement.  Whitney Software, Inc.  for their  excellent  Disk/EMS
  289.     memory swap routines.
  290.     And last (but NOT least!) the people that had the courage to beta-test  my
  291.     code.  A special word of thanks to Patty  Pickett,  sysop  of  "My  Secret
  292.     Garden RBBS".  Patty asked lots of questions setting  my  brain  in  gear,
  293.     provided feedback on errors in  the  program  and  documentation  and  she
  294.     volunteered to distribute updates to the beta-testers.  Kisses, Patty! You
  295.     earned yourself an original Dutch Cheese :-)
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.     What is RBBSMail                                                         4
  307.  
  308.  
  309.  
  310.                                  RBBSMail v18.2
  311.  
  312.  
  313.     3. Legal Stuff
  314.  
  315.  
  316.     3.1  Copyrights & License
  317.  
  318.  
  319.     RBBSMail is (C) Copyright 1988...1991 by Jan R.  Terpstra.
  320.     Disk/EMS swapping code is (C) Copyright 1990 Whitney Software, Inc.
  321.     Non-Commercial distribution and/or use is permitted  under  the  following
  322.     terms:
  323.  
  324.     1 - You may copy  and  distribute  verbatim  copies  of  RBBSMail  source,
  325.     documentation, and executable code as  you  receive  it,  in  any  medium,
  326.     provided that:
  327.  
  328.     ■   you conspicuously and appropriately  publish  on  each  copy  a  valid
  329.         copyright notice "(C) Copyright 1987, 1992 by Jan R.  Terpstra";
  330.     ■   you keep intact the notices on all files that refer  to  this  License
  331.         Agreement and to the absence of any warranty;
  332.     ■   you provide UNMODIFIED copies of the documentation  as  provided  with
  333.         the program;
  334.     ■   you give any other recipients of the RBBSMail program a copy  of  this
  335.         License Agreement along with the program.
  336.  
  337.     2 - You may not  charge  a  distribution  fee  for  the  physical  act  of
  338.     transferring a copy.  Under no circumstances is RBBSMail to be distributed
  339.     in such a way as to be construed as "value added" in a sales  transaction,
  340.     such as, but not limited to, software  bundled  with  a  modem  or  CD-ROM
  341.     software collections.
  342.  
  343.     3 - You may modify your copy or copies of RBBSMail or any portion  of  it,
  344.     and copy and distribute such modifications under the terms of Paragraph  1
  345.     above, provided that you:
  346.  
  347.     ■   send a complete copy of the modified source and executables to Jan  R.
  348.         Terpstra at the address on the title page of this  document,  for  the
  349.         purpose of evaluation for inclusion in future  releases  of  RBBSMail.
  350.         Should your source code be included  in  RBBSMail,  Jan  R.   Terpstra
  351.         retains all rights for redistribution of the code as part of  RBBSMail
  352.         and all derivative works, with appropriate credit given to the  author
  353.         of the modification,
  354.     ■   cause the modified files to carry prominent notices stating  that  you
  355.         changed the files and the date of any change,
  356.     ■   cause the executable code of such modified version to clearly identify
  357.         itself as such in the course of its normal operation,
  358.     ■   If the modified version is not a "port",  but  operates  in  the  same
  359.         hardware and/or software environment  as  the  original  distribution,
  360.         make the original version equally available, clearly identifying  same
  361.         as the original, unmodified version;
  362.     ■   cause the whole of any work that you distribute or  publish,  that  in
  363.         whole or in part contains or is a derivative of RBBSMail or  any  part
  364.         thereof, to be licensed at no charge to all  third  parties  on  terms
  365.         identical to those contained in this License  Agreement  (except  that
  366.         you may choose to grant more extensive warranty protection to some  or
  367.  
  368.  
  369.     Legal Stuff                                                              5
  370.  
  371.  
  372.  
  373.                                  RBBSMail v18.2
  374.  
  375.  
  376.         all third parties, at your option),
  377.     ■   You may not  charge  a  distribution  fee  for  the  physical  act  of
  378.         transferring a  copy.   You  may  not  offer  warranty  protection  in
  379.         exchange for a fee.
  380.  
  381.     4 - Mere aggregation of another unrelated program with  this  program  and
  382.     documentation  (or  derivative  works)  on  a  volume  of  a  storage   or
  383.     distribution medium does not bring the other program under  the  scope  of
  384.     these terms.
  385.  
  386.     5 - You may copy and distribute RBBSMail and its associated  documentation
  387.     (or a portion or derivative of it, under Paragraph 2) in  object  code  or
  388.     executable form under the terms of Paragraphs 1, 2 and  3  above  provided
  389.     that you also do one of the following:
  390.  
  391.     accompany it with the complete corresponding machine-readable source code,
  392.     which must be distributed under the terms of Paragraphs 1, 2 and 3 above,
  393.  
  394.     OR
  395.  
  396.     accompany it with a written offer, valid for at least three years, to give
  397.     any third party free a complete machine-readable copy of the corresponding
  398.     source code, to be distributed under the terms of Paragraphs 1,  2  and  3
  399.     above,
  400.  
  401.     OR
  402.  
  403.     accompany  it  with  the  information  you  received  as  to   where   the
  404.     corresponding source code may be obtained.  (This alternative  is  allowed
  405.     only for noncommercial distribution and only if you received  the  program
  406.     in object code or executable form alone.)
  407.  
  408.     For an executable file, complete source code means all the source code for
  409.     all modules it contains.  As exception, it need not  include  source  code
  410.     for modules which are standard libraries that accompany the compiler  used
  411.     to generate the object code or libraries that are part  of  the  operating
  412.     system on which the executable file runs.
  413.  
  414.     6 - You may not copy, sublicense, distribute or transfer RBBSMail and  its
  415.     associated documentation except as expressly provided under  this  License
  416.     Agreement.  Any attempt  otherwise  to  copy,  sublicense,  distribute  or
  417.     transfer RBBSMail is void and your rights to use the  program  under  this
  418.     License agreement shall be automatically terminated.  However, parties who
  419.     have received computer  software  programs  from  you  with  this  License
  420.     Agreement will not have their licenses terminated so long as such  parties
  421.     remain in full compliance, and notify Jan R.  Terpstra of their  intention
  422.     to comply with this Agreement.
  423.  
  424.     7 - If you wish to incorporate parts of RBBSMail into other free  programs
  425.     whose  distribution  conditions  are  different,  please  contact  Jan  R.
  426.     Terpstra at the address listed below.  There's not yet a simple rule  that
  427.     can be stated here, but it will usually be permitted this.  Such  decision
  428.     is guided  by  the  two  goals  of  preserving  the  free  status  of  all
  429.     derivatives of this free software (as it pertains to Non-Commercial use as
  430.  
  431.  
  432.     Legal Stuff                                                              6
  433.  
  434.  
  435.  
  436.                                  RBBSMail v18.2
  437.  
  438.  
  439.     provided by this Agreement) and of promoting  the  sharing  and  reuse  of
  440.     software.
  441.  
  442.     8 - For the purposes of this document,  "COMMERCIAL  USE"  is  defined  as
  443.     operation of the software with the intent of generating financial revenue,
  444.     where the revenue excesses the true  costs  of  running  the  organisation
  445.     (i.e.  profit).  The term  "COMMERCIAL  USE"  includes  use  by  religious
  446.     organisations, government agencies  and  organisation  raising  funds  for
  447.     third parties.
  448.     NON-PROFIT non-religious organization  or  individuals  may  operate  this
  449.     software under the terms of this Non-Commercial Agreement.
  450.  
  451.     9 - You may terminate this license at any time by  simply  destroying  all
  452.     copies of the RBBSMail executables, sourcecode and documentation you  have
  453.     in your posession.
  454.  
  455.  
  456.     3.2  NO WARRANTY
  457.  
  458.  
  459.     BECAUSE RBBSMAIL IS LICENSED FREE  OF  CHARGE,  I  PROVIDE  ABSOLUTELY  NO
  460.     WARRANTY.  EXCEPT WHEN OTHERWISE  STATED  IN  WRITING,  JAN  R.   TERPSTRA
  461.     AND/OR OTHER PARTIES PROVIDE RBBSMAIL "AS  IS"  WITHOUT  WARRANTY  OF  ANY
  462.     KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,  BUT  NOT  LIMITED  TO,  THE
  463.     IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A  PARTICULAR
  464.     PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE  OF  RBBSMail,
  465.     AND THE ACCURACY OF ITS ASSOCIATED DOCUMENTATION,  IS  WITH  YOU.   SHOULD
  466.     RBBSMail OR ITS ASSOCIATED DOCUMENTATION PROVE DEFECTIVE, YOU  ASSUME  THE
  467.     COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  468.  
  469.     IN NO EVENT WILL JAN R.  TERPSTRA  BE  RESPONSIBLE  IN  ANY  WAY  FOR  THE
  470.     BEHAVIOR OF MODIFIED VERSIONS OF  RBBSMAIL.   IN  NO  EVENT  WILL  JAN  R.
  471.     TERPSTRA AND/OR ANY OTHER PARTY WHO MAY MODIFY AND  REDISTRIBUTE  RBBSMail
  472.     AS PERMITTED ABOVE, BE LIABLE TO  YOU  FOR  DAMAGES,  INCLUDING  ANY  LOST
  473.     PROFITS, LOST  MONIES,  OR  OTHER  SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL
  474.     DAMAGES ARISING OUT OF THE USE OR INABILITY  TO  USE  (INCLUDING  BUT  NOT
  475.     LIMITED TO LOSS OF DATA  OR  DATA  BEING  RENDERED  INACCURATE  OR  LOSSES
  476.     SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  477.     OTHER PROGRAMS) RBBSMail, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY
  478.     OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  479.  
  480.     You can contact the author at address listed  on  the  titlepage  of  this
  481.     document.  Feel free to contact me at any  time  to  share  your  comments
  482.     about my software and/or  licensing  policies.   I  don't  always  listen,
  483.     though.
  484.  
  485.     For your info: RBBSMail was developed and compiled with Microsoft  C  6.00
  486.     and Microsoft MASM 5.10 on an IBM PS/2 mod70 with 12MB memory and a  160MB
  487.     fixed disk, running IBM OS/2 2.0.
  488.     This version was tested with RBBS-PC  17.3C,  ConfMail  v3.3,  BinkleyTerm
  489.     v2.55beta, FrontDoor  2.02,  oMMM  v1.70,  AMAX  v2.20  and  Maximus  CBCS
  490.     v2.01wb, on a machine running IBM OS/2 v2.0 and a machine running  IBM  PC
  491.     DOS v5.00 plus DESQview 2.26.
  492.  
  493.  
  494.  
  495.     Legal Stuff                                                              7
  496.  
  497.  
  498.  
  499.                                  RBBSMail v18.2
  500.  
  501.  
  502.     3.3  NO MONEY
  503.  
  504.  
  505.     Non-Commercial users  may  us  this  software  free  of  charge.   If  you
  506.     absolutely insist on spending money for RBBSMail, DO NOT put  a  check  in
  507.     the mail to me.  Instead, take your wife or girlfriend (not both!) out  to
  508.     dinner, to make up for the many, many hours you left her alone  while  you
  509.     were playing around with your BBS.......
  510.     Therefore, it is understood that RBBSMail is distributed as DINNERWARE.
  511.  
  512.     There's one absolute requirement for using this code: Send the  author  of
  513.     RBBSMail a nice postcard of a local scenery or from  your  next  vacation.
  514.     No windmills please :-)
  515.  
  516.  
  517.     3.4  The RBBS commitment
  518.  
  519.  
  520.     A quote from the RBBS docs: "Most Bulletin Board Software is dedicated  to
  521.     making money for its authors.  No matter how much  the  authors  love  the
  522.     work, it endures only so long as the hope of income continues.
  523.     RBBS is given away for free, and depends not on the flow of money, but  on
  524.     the continuing dedication and generosity of people who volunteer  to  help
  525.     support and enhance it as a public service, and share their labor of  love
  526.     with others for the benefit of all."
  527.  
  528.     This statement fully applies to RBBSMail as well.
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.     Legal Stuff                                                              8
  559.  
  560.  
  561.  
  562.                                  RBBSMail v18.2
  563.  
  564.  
  565.     4. Installation
  566.  
  567.  
  568.     4.1  Configuring RBBSMail
  569.  
  570.  
  571.     Installation of RBBSMail  is  pretty  straightforward.   The  installation
  572.     procedure assumes that  you  have  installed  RBBS-PC  and  your  frontend
  573.     mailer, with all the conferences, the RBBS-PC control files  and  suitable
  574.     batch files.  You should already have obtained all the stuff you  need  to
  575.     run as a FIDONET node, things like NET/NODE number, the NODELIST and  some
  576.     programs to maintain all the files.  Please read the documentation of your
  577.     frontend mailer about this.  Talk to the Sysop  of  your  host-node  about
  578.     setting up your mail schedules and mailrouting.
  579.  
  580.     Now, copy RBBSMail.EXE to  the  directory  where  you  keep  your  RBBS-PC
  581.     MESSAGE files.  Find out the EXACT filenames of all  the  conferences  you
  582.     are going to hook up in the Echomail and find out by what AREA:names  they
  583.     are known in the network you are participating  in.   You  also  need  the
  584.     NET/NODE number(s) of the system(s) you are going exchange echomail  with.
  585.     You can send any AREA: to a large number of different  systems.   This  is
  586.     usually not the case, you will probably exchange mail with a small  number
  587.     of neigbouring nodes or only with your Echomail HOST, HUB or backbone.
  588.  
  589.     Most local FIDONET nets have a single hostnode with some  5  to  20  nodes
  590.     connected.  Ask the sysop of your local or regional HOST/HUB for the EXACT
  591.     AREA: names used in your net.
  592.     RBBSMail can run your system as Echomail host so you can set up  your  own
  593.     local or regional net.
  594.  
  595.     If you have all  info  needed,  you  must  build  two  control  files  for
  596.     RBBSMail.  One is RBBSMAIL.CFG, containing the information RBBSMail  needs
  597.     to make your system talks to the rest of the net.  The other is AREAS.BBS,
  598.     the control file that lists all echomail areas  you  exchange  with  other
  599.     nodes.  We'll talk about AREAS.BBS later on.
  600.     The format of RBBSMAIL.CFG file has a layout similar to the  configuration
  601.     files used by BinkleyTerm, MsgEd and other FIDONET utilities.  In fact you
  602.     can run RBBSMail, MsgEd and BinkleyTerm using only a single  configuration
  603.     file by writing "application rbbsmail" in front of the  RBBSMail  specific
  604.     configuration  phrases  in  BINKLEY.CFG.   Refer   to   section   "Reading
  605.     BINKLEY.CFG" in this manual or  the  BinkleyTerm  documentation  for  more
  606.     info.
  607.  
  608.  
  609.     4.2  Valid phrases for RBBSMAIL.CFG
  610.  
  611.  
  612.     4.2.1  Address
  613.  
  614.     Up to 10  of  your  addresses,  these  must  be  full  fidonet  compatible
  615.     5-dimensional adresses in the format:
  616.  
  617.          ZONE:NET/NODE.POINT@domain
  618.  
  619.  
  620.  
  621.     Installation                                                             9
  622.  
  623.  
  624.  
  625.                                  RBBSMail v18.2
  626.  
  627.  
  628.     The first address listed is your primary address.  You may specify up to 9
  629.     additional addresses (i.e.  AKA, Also  Known  As  addresses).   The  FIRST
  630.     address listed in the configration file  will  be  used  as  your  primary
  631.     address.
  632.  
  633.     See also configuration phrase  PrivateNet  and  the  -OrgAddress  embedded
  634.     command in AREAS.BBS.
  635.  
  636.  
  637.     4.2.2  ARCto, ARJto, PAKto, LHAto, ZIPto, ZOOto.
  638.  
  639.     RBBSMail can use different compression methods  for  outgoing  ARCmail  to
  640.     different addresses.  You can tell RBBSMail what compression method to use
  641.     for a certain address by using the PAKto, ARJto,  LHAto,  ZIPto  or  ZOOto
  642.     configuration phrases in the format:
  643.  
  644.          XXXto <address> <address> <address> <address>
  645.  
  646.     This is perhaps best illustrated with an excerpt from a RBBSMAIL.CFG file:
  647.  
  648.          ARJto 8:900/1                 ; this one gets ARJ mail
  649.          LHAto 1:1/1                   ; he prefers LHA (LHARC)
  650.          PAKto 2:512/8                 ; this node gets PAK format ARCmail
  651.          ZIPto 2:555/666 2:789/789     ; but these guys can only handle ZIP mail
  652.          ZOOto 2:1010/2 2:1010/3       ; and finally a 2 ZOO lovers
  653.  
  654.     If an address is not listed for one of the preferred compression  methods,
  655.     RBBSMail will default to  old  style  ARCmail  compatible  mailbundles  by
  656.     calling the program ARCA.
  657.     For this option to work properly, the executable  files  ARJ.EXE  PAK.EXE,
  658.     LHA.EXE, PKZIP.EXE and ZOO.EXE must be in the current subdirectory or in a
  659.     subdirectory listed in your DOS PATH.
  660.  
  661.     These ARCmail options have only effect when using the commandline switches
  662.     -OF or -FA.
  663.     When using commandline switches -OB or -OP, an  external  mailpacker  (see
  664.     PACK configuration phrase) will be invoked and RBBSMail will not  use  the
  665.     internal ARCmail routines.
  666.  
  667.  
  668.     Warning to ARCmail users:
  669.     If you run Binkley as frontend mailer and oMMM as mailpacker, BE SURE that
  670.     both RBBSMail's ARCmail options  and  oMMM's  Stuffer<tm>  options  invoke
  671.     compression methods for the individual destination  nodes!  Otherwise  the
  672.     destination  node  may  receive  a  single   ARCmail   bundle   containing
  673.     mailbundles that where compressed by different compression programs.
  674.     If you use RBBSMail's internal ARCmail routines (either  the  -FA  or  -OF
  675.     commandline switch) and ALSO run oMMM  to  compress  and  route  ARCmailed
  676.     mailbundles, you may want to employ Johan Zwiekhorst's ARCA simulator.  If
  677.     you  do  not  configure  any  of  RBBSMail's  ARCmail  options  or  oMMM's
  678.     stuffer<tm> options, both programs will happily use Johan's ARCA simulator
  679.     as a drop-in replacement for ARCA.
  680.  
  681.     Johan's ARCA simulator has an external configuration file that allows  you
  682.  
  683.  
  684.     Installation                                                            10
  685.  
  686.  
  687.  
  688.                                  RBBSMail v18.2
  689.  
  690.  
  691.     to set different compression methods for different destination  addresses.
  692.     Using the ARCA simulator will ensure that the same compression program  is
  693.     used for each individual destination node,  both  by  RBBSMail  and  OMMM.
  694.     Plus you only need to change  ARCA's  config  file  if  your  distribution
  695.     changes and you don't  have  to  bother  with  either  RBBSMail's  ARCmail
  696.     options or oMMM's stuffer<tm> option.
  697.  
  698.  
  699.     4.2.3  StdARCmail
  700.  
  701.     The default ARCmail packing method is always Vernon Buerg's ARCA.  If  you
  702.     want a different default, configure one of the  following  the  StdARCmail
  703.     phrases:
  704.  
  705.         StdARCmail ARJ
  706.         StdARCmail LHA
  707.         StdARCmail PAK
  708.         StdARCmail ZIP
  709.         StdARCmail ZOO
  710.  
  711.  
  712.     4.2.4  Domain
  713.  
  714.     This phrase has become obsolete, you  should  specify  full  5-dimensional
  715.     addresses with the ADDRESS config phrase.
  716.  
  717.  
  718.     4.2.5  Elastic
  719.  
  720.     Per default, RBBSMail will attempt to keep RBBS-PC style message bases  at
  721.     a fixed size.  If you have  told  RBBS-PC's  CONFIG  program  to  let  the
  722.     message files' sizes grow as messages are added, set the Elastic phrase to
  723.     make optimum use of your disk space.
  724.  
  725.  
  726.     4.2.6  DupSize
  727.  
  728.     Tells RBBSMail how many message identifications of processed messages (per
  729.     conference) it should store to check for duplicate  messages.   The  value
  730.     can be 0...  3200, default is 512.  A value of 0  disables  the  duplicate
  731.     checking entirely.
  732.  
  733.     A higher value for DupSize makes RBBSMail  perform  slightly  slower  when
  734.     importing messages.
  735.     For systems with a low load of echomail, DupSize 200 will do.  On  systems
  736.     with an average load of echomail, the default is probably a  good  enough.
  737.     If you often find duplicate messages not caught by RBBSMail, increase  the
  738.     value of DupSize.
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.     Installation                                                            11
  748.  
  749.  
  750.  
  751.                                  RBBSMail v18.2
  752.  
  753.  
  754.     4.2.7  DynaPurge
  755.  
  756.     This tells RBBSMail to use dynamically purge (DynaPurge<tm>) any  messages
  757.     file in case it fills up beyond the maximum number of  messages  specified
  758.     for that conference via RBBS-PC's CONFIG option 166.
  759.     The DynaPurge<tm> feature requires RBBSMNT version 2.10 or later and  this
  760.     program  may  also  be  used  stand-alone  for  messages  and  users  file
  761.     maintenance.
  762.  
  763.     WARNING: Do NOT use DynaPurge or RBBSMNT by itself in a  multi-node  setup
  764.     without bringing ALL your nodes off-line!! If a user is  on-line  using  a
  765.     RBBS-PC conference while RBBSMNT is rebuilding that conference at the same
  766.     time, the user will see unpredictable results on his screen.
  767.     Here's why: RBBS-PC builds an internal list of messages when a user enters
  768.     a conference.  This list of messages is only updated when the  user  scans
  769.     for personal mail.  RBBS-PC has no way of figuring out that the conference
  770.     file it is currently using was rebuild by an external program, and that it
  771.     needs to rebuild the internal message list.
  772.     RBBSMNT has no way of figuring out  if  the  conference  it  is  about  to
  773.     rebuild is in use by one or more nodes of RBBS-PC and that it should leave
  774.     that conference  alone.   This  problem  is  not  caused  by  RBBSMail  or
  775.     RBBSMNT.  It is just plain  impossible  to  rebuild  a  messages  file  if
  776.     RBBS-PC is using the file at the same time.  Period.
  777.  
  778.     See also the -Slack and -MsgAge embedded commands.
  779.  
  780.  
  781.     4.2.8  ExportComments
  782.  
  783.     Whether or not to export comments from a conference  is  now  configurable
  784.     per  separate  conference  via  embedded  commands  in   AREAS.BBS.    The
  785.     ExportComments configuration phrase in RBBSMAIL.CFG is now obsolete.
  786.  
  787.  
  788.     4.2.9  Gate
  789.  
  790.     ZONE:NET/NODE address of a ZONEgate or ECHOgate  (HUB),  followed  by  the
  791.     NET/NODE number that should  appear  in  the  SEEN-BY  lines  in  messages
  792.     addressed to that gateway node.
  793.     Normally, a SEEN-BY line to an ECHOgate  or  ZONEgate  only  contains  the
  794.     gate's NET/NODE and the NET/NODE (and applicable AKA  addresses)  of  your
  795.     own system.  You may  define  up  to  10  gates.   Ignored  for  2D  point
  796.     operation.
  797.  
  798.     If you are serving as Echomail hostsystem and also send echoes to the host
  799.     of another net, you and the other  hosts  are  only  concerned  about  the
  800.     SEEN-BY info for your respective nets only and there is no need  to  carry
  801.     all SEEN-BY info over to the other net.  The two host systems only have to
  802.     tell each other the fact that they have seen the message.  All other  info
  803.     about what happened to the message in the one net is of no interest to the
  804.     other net.  Having a short SEEN-BY line keeps down the mailcost  for  ZONE
  805.     and ECHO gates.
  806.  
  807.  
  808.  
  809.  
  810.     Installation                                                            12
  811.  
  812.  
  813.  
  814.                                  RBBSMail v18.2
  815.  
  816.  
  817.     4.2.10  Hold
  818.  
  819.     This is the  subdirectory  where  RBBSMail  writes  outgoing  mailbundles,
  820.     ARCmailed bundles and Binkley compatible FLO files.
  821.     If you run BinkleyTerm and send echomail to other zones than your  primary
  822.     zone, you also need the proper subdirectories for outbound mail  to  those
  823.     zones.  If "HOLD C:\BINKLEY\HOLD" is specified  as  outbound  subdirectory
  824.     and you send mail to Zone 8, the subdirectory  "C:\BINKLEY\HOLD.008"  must
  825.     also be present.  on your disk.
  826.  
  827.  
  828.     4.2.11  IBMFLAGS
  829.  
  830.     If you are using multiple RBBS-PC nodes sharing the  same  messages  files
  831.     under NETBIOS file locking via RBBS-PC's "semaphore"  file,  you  need  to
  832.     tell RBBSMail where it can find the  semaphore  file  IBMFLAGS.   This  is
  833.     usually located the same subdir as your RBBS-PC messages files.
  834.  
  835.     See also the UseNETBIOS configuration phrase.
  836.  
  837.  
  838.     4.2.12  ImportDate
  839.  
  840.     This phrase tells RBBSMail to stamp local messages with the CURRENT  date,
  841.     not with the date  the  message  was  originally  entered.   All  imported
  842.     messages will carry the date/time stamp of  the  moment  the  message  was
  843.     imported to your system.  If you kill messages by age,  then  the  message
  844.     age will be calculated  from  the  moment  the  message  arrived  on  your
  845.     system.  In echomail conferences with a high amount  of  traffic  you  may
  846.     wish to kill messages after a short time.  Thus  there's  a  chances  that
  847.     your message maintenance utility will kill a message right after  RBBSMail
  848.     imported it.
  849.  
  850.     Note: This option works for RBBS-PC style messages files only.
  851.  
  852.  
  853.     4.2.13  Indomain
  854.  
  855.     See section "CrossZone  Echomail"  for  information  about  setting  up  a
  856.     Network Gateway system.  This phrase is ignored for 2D point operation.
  857.  
  858.  
  859.     4.2.14  KeepDups
  860.  
  861.     Normally, RBBSMAil discards duplicate messages.  However, you may wish  to
  862.     keep duplicate messages for manual inspection.  With the  KeepDups  config
  863.     phrase, you can tell RBBSMail to dump a copy of duplicate messages in  the
  864.     BAD_MSGS directory.
  865.     A line stating "** DUPLICATE MESSAGE **" will be added to the top  of  the
  866.     message text.  This will move the AREA: tag  from  the  first  line,  with
  867.     prevents the message being tossed if using the -BM commandline switch.
  868.  
  869.     See also the -BM commandline switch.
  870.  
  871.  
  872.  
  873.     Installation                                                            13
  874.  
  875.  
  876.  
  877.                                  RBBSMail v18.2
  878.  
  879.  
  880.     4.2.15  KillNull
  881.  
  882.     This phrase tells RBBSMail to discard all messages without human  readable
  883.     contents.  Control information  (i.e.   any  text  "hidden"  by  a  Ctrl-A
  884.     kludges) is not treated as human readable text.  This option is especially
  885.     usefull to automatically kill FileAttach, FileRequest or empty messages.
  886.  
  887.     This option can also be switched on with the -KN commandline switch.
  888.  
  889.  
  890.     4.2.16  LogLevel
  891.  
  892.     This phrase tell RBBSMail which  error  messages,  progress  messages  and
  893.     reports should be written to the  logfile.   Loglevel  can  be  any  value
  894.     between 0 and 4, which has the following effect
  895.  
  896.     0         Do not write to the log at all.
  897.     1         Only log critical errors.
  898.     2         Log critical and non-critical errors.
  899.     3         Log critical errors, non-critical errors and progress messages.
  900.     4         Log critical errors, non-critical errors, progress messages  and
  901.               statistics.
  902.  
  903.     See also configuration phrase StatusLog.
  904.  
  905.  
  906.     4.2.17  MaxOut
  907.  
  908.     This tells RBBSMail after how many exported messages it should invoke  the
  909.     mailpacking routine.  When the -OB or -OP  commandline  switch  is  given,
  910.     RBBSMail will invoke the external mailpacker.  See also  the  PACK  phrase
  911.     below.
  912.     If the -FA or -OF comandline  switch  is  given,  RBBSMail  will  run  the
  913.     internal ARCmail routines each time after MaxOut messages are exported.
  914.  
  915.     By packing outgoing mail  each  time  a  certain  number  of  messages  is
  916.     exported, your outgoing mailbundles will  be  relatively  small  in  size.
  917.     Some other echomail processors, like ConfMail, work more effectively  with
  918.     small mailbundles.  The number behind MaxOut can be between 1  and  32676.
  919.     A value between 25 and 250 is recommended, Setting MaxOut to zero disables
  920.     the on-the-fly packing and the final ARCmail bundles plus  the  FLO  files
  921.     (or FileAttach messages) will be build when  RBBSMail  has  processed  all
  922.     message areas.
  923.  
  924.  
  925.     4.2.18  NetFile
  926.  
  927.     Subdirectory  where  RBBSMail  can  find  incoming   FTS-0001   compatible
  928.     mailbundles.   and  ARCmail  bundles.   In  other  words,  this   is   the
  929.     subdirectory where your mailer saves files it receives.
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.     Installation                                                            14
  937.  
  938.  
  939.  
  940.                                  RBBSMail v18.2
  941.  
  942.  
  943.     4.2.19  UseNETBIOS
  944.  
  945.     RBBSMail can optionally do file/record locking via standard NETBIOS  calls
  946.     for all *.MSG files and do  RBBS-PC  compatible  "semaphore"  locking  for
  947.     RBBS-PC messages and user files.  NETBIOS filelocking can be  switched  on
  948.     with this configuration phrase.
  949.  
  950.     For this to work properly, you also need to tell  RBBSMail  where  it  can
  951.     find the RBBS-PC semaphore file.
  952.     See also configuration phrase IBMFLAGS.
  953.  
  954.  
  955.     4.2.20  UseDV
  956.  
  957.     RBBSMail can optionally do file locking when running under DESQview.  This
  958.     option can be switched on with the UseDV configuration phrase.
  959.  
  960.     If UseDV is configured, RBBSMail will check for DESQview being loaded  and
  961.     use the DESQview semaphore mailbox interface to lock files.
  962.  
  963.     File locking via DESQview is automatically switched off if DESQview  isn't
  964.     loaded.  This allows you to run under plain DOS or under DESQview at  will
  965.     without changing the RBBSMAIL.CFG file.
  966.  
  967.  
  968.     4.2.21  NoRts
  969.  
  970.     Normally,  RBBSMail  returns  all  incorrect  echomail  messages  to   the
  971.     orignator and tosses a copy to the BAD_MSGS area for later inspection.  If
  972.     the phrase NoRts is present, RBBSMail will not return  incorrect  messages
  973.     to the sender.
  974.     See also the  -S  commandline  option  and  the  SecureMail  configuration
  975.     phrase.
  976.  
  977.  
  978.     4.2.22  NetBrick
  979.  
  980.     If RBBSMail finds a  defect  in  an  incoming  message,  it  will  send  a
  981.     complaining message to the originator of  the  message.   The  complaining
  982.     messages are commonly known as NetBricks<tm>.  The "grunts" depend on  the
  983.     level setting of the NetBrick config phrase:
  984.  
  985.         0 - disable sending NetBricks.
  986.         1 - Complain about Incorrect date/time  fields  (caused  by  braindead
  987.         mailpackers).
  988.         2 - Complain about #1 and Missing Origin lines  (caused  by  braindead
  989.         sysops).
  990.         3 - Complain abour #1, #2 and if  "SysOp"  in  the  to/from  field  of
  991.         messages was not changed to the SysOp's real name (caused by braindead
  992.         echomail processors).
  993.         4 - Complain about #1, #2, #3 and redundant kludge  lines  (caused  by
  994.         Fidonet utility writers with a big ego).  Level 4  also  requires  the
  995.         phrase NoStinkingKludgeLines to be configured.
  996.  
  997.  
  998.  
  999.     Installation                                                            15
  1000.  
  1001.  
  1002.  
  1003.                                  RBBSMail v18.2
  1004.  
  1005.  
  1006.     To prevent  yourself  from  becoming  too  annoying  about  these  things,
  1007.     RBBSMail will keep track of who it sends a NetBrick<tm> and will send only
  1008.     one such message to an offending node during a RBBSMail run.
  1009.  
  1010.     However, if you have no intention to earn yourself the title
  1011.  
  1012.          Fidonet's-Pain-In-The-Behind-Of-The-Month
  1013.  
  1014.     set the NetBrick value to 0, thus disabling the NetBrick<tm> thrower.
  1015.  
  1016.  
  1017.     4.2.23  NoStinkingKludgeLines
  1018.  
  1019.     This option causes RBBSMail to strip all redundant "kludge lines" from all
  1020.     incoming echomail messages.  Only AREA, MSGID,  REPLY,  SEEN-BY  and  PATH
  1021.     kludges will be left intact.  All other tags, including common idiocy like
  1022.     PID, OSE, TCL and Via lines will be removed from the echomail messages.
  1023.  
  1024.     This option, in combination with the NetBrick<tm>  thrower,  will  usually
  1025.     bring the offending SysOps and/or software authors to their right sense of
  1026.     mind.
  1027.  
  1028.  
  1029.     4.2.24  OpusDate
  1030.  
  1031.     This phrase tells RBBSMail to write all FIDO style (*.MSG)  messages  with
  1032.     Opus/Maximus compatible date/time stamps  in  the  message  header.   This
  1033.     allows you to do maintenance on those message bases using Opus or  Maximus
  1034.     utilities  like  Renum  and  ReplyLink.   Note:  Messages  stored  in  the
  1035.     OVERFLOW, BAD_MSGS and NETMAIL subdirs will NEVER carry an Opus  date/time
  1036.     stamp.  Messages in these directories will always carry a FTS-0001 rev  15
  1037.     compliant message header.
  1038.  
  1039.  
  1040.     4.2.25  Pack
  1041.  
  1042.     The name of the external packer program  to  be  invoked  by  RBBSMail  to
  1043.     packup your outgoing mail.  This normally calls oMMM  or  a  similar  mail
  1044.     packing program to bundle and route outgoing mail.  See  also  the  MaxOut
  1045.     phrase above.
  1046.  
  1047.     The program listed  after  PACK  can  be  either  the  name  and  optional
  1048.     parameters  of  your  mail  packer  OR  the  full  drive/path/filename  of
  1049.     COMMAND.COM, followed by  /C,  followed  by  the  name  of  the  batchfile
  1050.     invoking your mailpacker.
  1051.  
  1052.     For instance, the PACK phrase can list oMMM with all parameters:
  1053.  
  1054.       PACK  oMMM -i\BINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  1055.  
  1056.     If you run your mailpacker via a batchfile, you MUST  specify  COMMAND.COM
  1057.     /C followed by the name of the batchfile.  This  may  seem  odd,  but  the
  1058.     Disk/EMS swapping mechanism used by  RBBSMail  requires  that  you  invoke
  1059.     batchfiles via a secondary copy of COMMAND.COM:
  1060.  
  1061.  
  1062.     Installation                                                            16
  1063.  
  1064.  
  1065.  
  1066.                                  RBBSMail v18.2
  1067.  
  1068.  
  1069.  
  1070.       PACK C:\DOS\COMMAND.COM /C PACKMAIL.BAT
  1071.  
  1072.     The batch file (named PACKMAIL.BAT) can look something like  this  if  you
  1073.     run ReMapper and oMMM:
  1074.  
  1075.       @ECHO OFF
  1076.       CD\BINKLEY
  1077.       REMAPPER 9999 -fpi
  1078.       oMMM -iBINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  1079.       CD\RBBS
  1080.  
  1081.     Today, it is very common to compress mailbundles before they are  sent  to
  1082.     another system.  This will, in some cases, save over 50% of connect  time.
  1083.     For INcoming mailbundles, RBBSMail  recognizes  most  popular  compression
  1084.     format internally  and  will  invoke  the  proper  decompression  program.
  1085.     Mailbundles compressed by  ARC/PAK/PKARC,  ARJ,  LHA  (formerly  known  as
  1086.     LHARC), PKZIP and ZOO will be detected automatically.  If the  compression
  1087.     method of a mailbundle cannot be determnined, RBBSMail will try to  invoke
  1088.     GUS, a General Unpack Shell written by Johan Zwiekhorst.
  1089.     For  this  to  work  properly,  the  executable  files  PAK.EXE,  LHA.EXE,
  1090.     PKUNZIP.EXE, ZOO.EXE and GUS.EXE must be in the current subdirectory or in
  1091.     a subdirectory listed in your DOS PATH environment variable.
  1092.  
  1093.     Note: Whatever is listed at the PACK phrase will be executed  just  before
  1094.     RBBSMail finishes the current run.
  1095.  
  1096.  
  1097.     4.2.26  PrivateNet
  1098.  
  1099.     Is the NETnumber of your private network for points.  This phrase has  two
  1100.     functions:
  1101.  
  1102.  
  1103.     For BOSSnodes:
  1104.     If  your  system  services  points  as  a  BOSS  node,  you  MUST  specify
  1105.     PrivateNet, no matter if your points are addresses as 2-dimenional  points
  1106.     in your PrivateNet or as full 4-dimensional points.
  1107.     To accomodate frontend mailers like FrontDoor and Intermail, RBBSMail  can
  1108.     exchange echomail with your points using 4-dimensional  addressing.   When
  1109.     receiving echomail,  RBBSMail  will  automatically  detect  what  type  of
  1110.     mailbundle it is processing:
  1111.  
  1112.     1.  FTS-0001 compliant bundles with 2-dimensional addressing  (also  known
  1113.         as StoneAge mailbundles).  This type of bundle only contains  Net  and
  1114.         Node addresses.
  1115.     2.  FTS-0001 revision 015 compliant bundles with 3D addressing.  This type
  1116.         of mailbundle only contains Zone, Net  and  Node  addressing,  but  no
  1117.         point addressing.
  1118.     3.  FSC-0039/FSC-0048 compliant bundles with 4D addressing.  This type  of
  1119.         mail bundle is commonly  known  as  "Type  2+"  and  is  supported  by
  1120.         programs like GEcho, XGROUP,  FrontDoor,  InterMail  and  (of  course)
  1121.         RBBSMail.
  1122.  
  1123.  
  1124.  
  1125.     Installation                                                            17
  1126.  
  1127.  
  1128.  
  1129.                                  RBBSMail v18.2
  1130.  
  1131.  
  1132.     4.  FSC-0045 compliant mailbundles with 5D addressing.  This type of  mail
  1133.         bundle is commonly known as "Type 2.2" and carries  Zone,  Net,  Node,
  1134.         Point and domain information and is supported by programs like SEAdog,
  1135.         SEAmail  and  Groupmail.   RBBSMail  will  recognize  this   type   of
  1136.         mailbundle, but doesn't currently do anything with the Domain part  of
  1137.         the addresses.  RBBSMail just does 4 dimensional addressing.
  1138.  
  1139.     BinkleyTerm does not use any of the above 4-dimensional methods to address
  1140.     points.  Binkley uses separate subdirectories to store mail  addressed  to
  1141.     point systems.
  1142.     If you run RBBSMail with either the  -OB,  -OF,  -OP  or  -FA  commandline
  1143.     switch AND you have 4D points in your AREAS.BBS,  RBBSMail  will  use  the
  1144.     same subdir scheme.  POINT subdirs, as well as outbound subdirs for  other
  1145.     zones, are dynamically created whenever RBBSMail needs them.  RBBSMail can
  1146.     be configured to write outbound mailbundles in either FSC-0039 or FSC-0045
  1147.     format.  See configuration phrase FSC-0045 for details.
  1148.  
  1149.  
  1150.     For POINTS:
  1151.     If you are running as a point (i.e.  the point part of you primary address
  1152.     is not zero), the behaviour of your point is affected  by  the  PrivateNet
  1153.     setting in the following way:
  1154.  
  1155.     ■   If your primary address is a point and you do NOT specify  PrivateNet,
  1156.         your point will appear  to  your  boss  with  the  full  4-dimensional
  1157.         primary address.
  1158.     ■   If your primary address is a point and you DO specify PrivateNet, your
  1159.         point will appear to your boss  with  a  2-dimensional  address,  i.e.
  1160.         point 2:512/10.7 will show up as <PrivateNet>/7.
  1161.  
  1162.  
  1163.     4.2.27  Force2D
  1164.  
  1165.     If you address points with their 2-dimensional FakeNet address, it may  be
  1166.     possible that your points send messages with their 4-dimensional  address.
  1167.     This causes the mail from the 4D points  to  be  send  back  to  their  2D
  1168.     address, which is not what we want.  The Force2D configuration phrase tell
  1169.     RBBSMail to always treat any mail from a 4D point as if it originated from
  1170.     a point with a 2D FakeNet address.
  1171.  
  1172.     This is especially usefull if you feed points from a system not capable of
  1173.     addressing mailbundles to 4D points (Dutchie) or systems that do recognize
  1174.     4D addresses for incoming calls but don't do anything special with the  4D
  1175.     address (like BinkleyTerm without *.PNT subdirs).  Your  points  can  take
  1176.     advantage of processing their mail with a 4D  capable  echomail  processor
  1177.     (TossSCan, GEcho) and present themself to your system with a  4D  frontend
  1178.     mailer (FrontDoor, Intermail) with appropriate AKAs, while your setup  can
  1179.     remain completely ignorant of anything but FakeNet addresses
  1180.  
  1181.     Note: This works  FOR  YOUR  OWN  POINTS  ONLY.   Other  points  using  4D
  1182.     addresses will still be handled as 4D points.
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.     Installation                                                            18
  1189.  
  1190.  
  1191.  
  1192.                                  RBBSMail v18.2
  1193.  
  1194.  
  1195.     4.2.28  FSC-0045
  1196.  
  1197.     By default, RBBSMail writes outbound mailbundles according to the FSC-0039
  1198.     specification.  By setting the  FSC-0045  configuration  phrase,  RBBSMail
  1199.     will be told to write  outbound  mailbundles  according  to  the  FSC-0045
  1200.     specs.
  1201.  
  1202.     Note: RBBSMail does currently NOT support domain addressing and  thus  the
  1203.     domain fields in the FSC-0045 mailbundle header will be empty.
  1204.  
  1205.  
  1206.     4.2.29  Size
  1207.  
  1208.     Maximum size (in BYTES) of incoming messages.  All  messages  larger  than
  1209.     this will be ignored.  RBBSMail's internal limit is 32000  bytes  for  all
  1210.     messages, but you may want to set this to a lower value.
  1211.  
  1212.     Note: Most sysops pay the bill for Echomail out of their  own  pocket,  so
  1213.     messages in the Echomail should be kept small to keep  down  the  cost  of
  1214.     mail distribution.  Sending large Echomail messages  (say,  over  10KB  in
  1215.     size) may be considered anti-social.....
  1216.  
  1217.  
  1218.     4.2.30  Security
  1219.  
  1220.     The security all imported messages are set to.  A  user  has  to  have  at
  1221.     least this access level  to  read  any  imported  Echomail.   Ignored  for
  1222.     messages in FIDO style message subdirectories.
  1223.  
  1224.     See also the -Security embedded command.
  1225.  
  1226.  
  1227.     4.2.31  SecureMail
  1228.  
  1229.     This phrase tells RBBSMail to  always  handle  echomail  in  secure  mode.
  1230.     Effectively this tells RBBSMail to always assume that the -S comand switch
  1231.     was given.
  1232.     See the -S commandline option for details.
  1233.  
  1234.  
  1235.     4.2.32  StatusLog
  1236.  
  1237.     The name of the logfile to use.  If no StatusLog  is  specified,  filename
  1238.     RBBSMAIL.LOG is used.
  1239.     See also the LogLevel configuration prhase.
  1240.  
  1241.  
  1242.     4.2.33  StripSeen
  1243.  
  1244.     If this phrase is configured, RBBSMail will strip  the  SEEN-BY  and  PATH
  1245.     lines from all messages imported to RBBS-PC style  message  bases.   Since
  1246.     messages in RBBS-PC conferences are never exported once they're  imported,
  1247.     the SEEN-BY and PATH lines have no  purpose  once  the  message  has  been
  1248.     written to a RBBS-PC conference file.  The echomail control lines  can  be
  1249.  
  1250.  
  1251.     Installation                                                            19
  1252.  
  1253.  
  1254.  
  1255.                                  RBBSMail v18.2
  1256.  
  1257.  
  1258.     stripped to save some diskspace.
  1259.  
  1260.     If  you  have  the  urge  to  manually  inspect  the  flow   of   echomail
  1261.     distribution, for instance if your  systems  receives  lots  of  duplicate
  1262.     messages or just because you're curious, you do need the echomail  control
  1263.     lines.  If so, do not configure StripSeen in RBBSMAIL.CFG.
  1264.  
  1265.  
  1266.     4.2.34  SwapPath
  1267.  
  1268.     The drive and subdirectory of  the  swapper  file.   When  RBBSMail  calls
  1269.     external programs, the entire RBBSMail executable is swapped out of memory
  1270.     to give the external program as much free memory as possible.
  1271.     Only about 1800 bytes of RBBSMail will remain in memory while the external
  1272.     program  runs.   Swapping  will  be  done  to  EMS  memory,  if  available
  1273.     available.  If insufficient EMS memory is available, RBBSMail will swap to
  1274.     disk.
  1275.     The drive and directory you set SwapPath to must have a minimum of 256  KB
  1276.     free space.  Or more depending on how many areas you  have  configured  in
  1277.     AREAS.BBS.  It is recommended to set SwapPath to a VDISK.  If SwapPath  is
  1278.     not configured, swapping will be done to the rootdirectory of the  current
  1279.     drive.
  1280.  
  1281.  
  1282.     Note: RBBSMail proudly uses Disk/EMS  swapping  code  written  by  Whitney
  1283.     Software, Inc.
  1284.  
  1285.  
  1286.     4.2.35  NoSwap.
  1287.  
  1288.     If, for any reason, you do not want RBBSMail to swap itself out of  memory
  1289.     as described above, set the NoSwap configuration phrase.
  1290.  
  1291.  
  1292.     4.2.36  SysAlias
  1293.  
  1294.     The alias name sysop uses to logon remotely to  RBBS-PC.   Beginning  with
  1295.     RBBS-PC v16.1A, the sysop's alias  name  is  listed  in  the  USERS  file.
  1296.     RBBSMail needs to know this alias to find the sysop  entry  in  the  USERS
  1297.     file to be able to flip the 'messages waiting' indicator for the sysop.
  1298.  
  1299.  
  1300.     4.2.37  Sysop
  1301.  
  1302.     The name you are using as sysop of your system.  Whatever you specify here
  1303.     will be overridden if you specify a SYSOP name after the  Origin  line  in
  1304.     AREAS.BBS.
  1305.  
  1306.  
  1307.     4.2.38  YabomFA
  1308.  
  1309.     Some BinkleyTerm utilities (Yabom  et  al)  expect  a  slightly  different
  1310.     notation for ARCmail with a file-attach message.  For some curious reason,
  1311.     Yabom needs a "#" in the attach message's subject field,  right  in  front
  1312.  
  1313.  
  1314.     Installation                                                            20
  1315.  
  1316.  
  1317.  
  1318.                                  RBBSMail v18.2
  1319.  
  1320.  
  1321.     filename of the attached ARCmail bundle.  By configuring the phrase below,
  1322.     RBBSMail will put the "#" where Yabom expects it.
  1323.  
  1324.     Note: Use  this  *ONLY*  if  you  build  ARCmail  file-attaches  (the  -FA
  1325.     commandline switch) on a Binkley system and use a  Yabom-like  utility  to
  1326.     convert the fileAttach messages to something  your  mailpacker/router  can
  1327.     deal with.  Please  remember  that  the  -OF  commandline  switch  is  the
  1328.     recommended way to build ARCmail on a Binkley system.
  1329.  
  1330.  
  1331.     4.2.39  Reading BINKLEY.CFG
  1332.  
  1333.     As noted before, RBBSMail is capable of using the  configuration  file  of
  1334.     other programs  like  BinkleyTerm.   The  configuration  phrases  Address,
  1335.     Netfile,  Hold,  Sysop  and  PrivateNet  are  then  read   directly   from
  1336.     Binkleyterm's configuration file.
  1337.     RBBSMail configuration phrases can be  added  to  BINKLEY.CFG  by  putting
  1338.     APPLICATION RBBSMAIL in front of the configuration phrase.
  1339.     For example, to enter the SECURITY phrase in BINKLEY.CFG, add the line:
  1340.  
  1341.       Application RBBSMail Security 4
  1342.  
  1343.     Please refer to the BinkleyTerm documentation for more info.
  1344.  
  1345.     Note: As RBBSMAIL cannot read nested configuration files, you  cannot  use
  1346.     the INCLUDE statement in your BINKLEY.CFG file.
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.     Installation                                                            21
  1378.  
  1379.  
  1380.  
  1381.                                  RBBSMail v18.2
  1382.  
  1383.  
  1384.     4.2.40  Example of a RBBSMAIL.CFG file
  1385.  
  1386.  
  1387.       ; Lines starting with a ';' are comment lines.  BLANK lines are ignored.
  1388.       ;
  1389.       Address    2:512/10.0@fidonet
  1390.       Address    2:512/101.0@fidonet
  1391.       Address    8:998/1.0@rbbsnet
  1392.       Address    8:998/0.0@rbbsnet
  1393.       NetFile    C:\BT\NETFILES
  1394.       Hold       C:\BT\HOLD
  1395.       PrivateNet 9999
  1396.       SysAlias   Buck Rogers
  1397.       Sysop      John Software
  1398.       Size       9000
  1399.       Security   4
  1400.       Gate       1:1/0.0  1/0 512/10 101
  1401.       Gate       2:2/0.0  2/0 512/10 101
  1402.       Gate       3:3/0.0  3/0 512/10 101
  1403.       Gate       8:8/0.0  8/0 512/10 926/0 1
  1404.       Pack       COMMAND.COM /C C:\BINKLEY\PACKMAIL.BAT
  1405.       ZIPto      2:512/0.0 2:512/101.0
  1406.       PAKto      8:926/1.0
  1407.       NoStinkingKludgeLines
  1408.       SecureMail
  1409.       DupSize    1024
  1410.       ImportDate
  1411.       KeepDups
  1412.       NoRts
  1413.       SwapPath   D:\TMP
  1414.  
  1415.     (another example is included in this package, see file EXAMPLE.CFG).
  1416.     Put the config file RBBSMAIL.CFG  in  your  RBBS-PC  directory,  edit  the
  1417.     entries to reflect your specific system setup and remove all comments  for
  1418.     speed.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.     Installation                                                            22
  1441.  
  1442.  
  1443.  
  1444.                                  RBBSMail v18.2
  1445.  
  1446.  
  1447.     The second file you need is named AREAS.BBS (for historic reasons).   This
  1448.     file lists all the conferences you want to hook up to Echomail, the  AREA:
  1449.     tag for that conference and the systems you want to send the Echomail to.
  1450.  
  1451.     Addresses must be specified in 3D (zone:net/node).  If addressing a point,
  1452.     it must be specified in 4D (zone:net/node.point) fashion.
  1453.     The addresses are "sticky", i.e.  if you must address a string of nodes in
  1454.     the same network or a number of nodes under the smae boss, you can use the
  1455.     shorthand notation.  Example:
  1456.  
  1457.          2:500/1.0 2:512/2.0 2:512/3.0 2:512/10.1 2:512/10.2 8:914/1.0 8:914/3.0
  1458.  
  1459.     can be written in shorthand as:
  1460.  
  1461.          2:500/1 512/2 3 10.1 .2 8:914/1 3
  1462.  
  1463.  
  1464.     4.2.41  Example of an AREAS.BBS file
  1465.  
  1466.     For embedded commands, please refer to the section "Embedded  commands  in
  1467.     AREAS.BBS" in this document.
  1468.  
  1469.       ; Lines starting with ';' or '-' are comment lines, so are BLANK lines
  1470.       ; First non-commented line has the Origin line ! optional SYSOP name
  1471.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1472.       ; all subsequent lines have either
  1473.       ;   RbbsFileName  AreaName  SendToList
  1474.       ; or
  1475.       ;   MsgSubdir     AreaName  SendToList
  1476.       ;
  1477.       ; You MUST at least have the areas NETMAIL and BAD_MSGS in your AREAS.BBS file
  1478.       ; Per conference, you can have up to 50 destination zone:net/node numbers.
  1479.       ; Addresses must be specified in 3D (zone:net/node), if addressing a point,
  1480.       ; it must be specified in 4D (zone:net/node.point) fashion.
  1481.       ; The ZONE and NET part are sticky.
  1482.  
  1483.       C:\BINK\NETMAIL\    NETMAIL
  1484.       C:\BINK\BAD_MSGS\   BAD_MSGS
  1485.       ;
  1486.       ; Some Embedded Commands:
  1487.       -Security 5
  1488.       -Margin 66
  1489.       -MaxLines 35
  1490.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 512/10.2 2 9999/1 8:926/1
  1491.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1492.       -OrgAddress 8:998/1.0@rbbsnet
  1493.       C:\RBBS\RBBSMM.DEF  RBBSMAIL 8:926/1
  1494.       ;orgaddress resets after each area!!!!
  1495.       -OrgAddress 8:998/1.0@rbbsnet
  1496.       C:\RBBS\RBBSM.DEF   RBBS-PC  2:512/1 6 8:926/1
  1497.       C:\BINK\SYSOPS\     SYSOP    2:512/1
  1498.       C:\BINK\PASSTHRU\   !WINDOWS 2:512/1
  1499.       C:\BINK\PASSTHRU\   XMODEM   2:512/1
  1500.  
  1501.  
  1502.  
  1503.     Installation                                                            23
  1504.  
  1505.  
  1506.  
  1507.                                  RBBSMail v18.2
  1508.  
  1509.  
  1510.     (see also EXAMPLE.BBS in this package).
  1511.  
  1512.     This AREAS.BBS example will have the following result:
  1513.  
  1514.     ■   The string "The Tenniscourt, Herejezusveen, The Netherlands"  will  be
  1515.         used as the * Origin: line in all outgoing Echomail  originating  from
  1516.         your system.  This way, anybody on any other system  will  know  where
  1517.         the message was originally entered.
  1518.  
  1519.     ■   If an outgoing message has SYSOP in the  address  field,  it  will  be
  1520.         replaced by the name John Software.  This way, other sysops  will  not
  1521.         find that message addressed to themselves, avoiding confusion.
  1522.         If you specify the OPTIONAL sysop name this way, it will overrride the
  1523.         SYSOP entry of RBBSMAIL.CFG.
  1524.  
  1525.     ■   If an incoming message has John Software in the address field, it will
  1526.         be replaced by SYSOP.  This way, the message scan function of  RBBS-PC
  1527.         will identify those messages as being addressed to SYSOP.
  1528.  
  1529.     ■   All messages in the file TENNISM.DEF will be sent to nodes  512/1  and
  1530.         512/2 in ZONE 2, to node 926/1 in zone 8, and they will to node 9999/1
  1531.         in the private network (using the 2-dimensional  FakeNet  address  for
  1532.         point 2:512/10.1)) network and to point 2:512/10.2))
  1533.         Wen messages are send out, an AREA: tag TENNIS  will  be  put  in  the
  1534.         first line of the message.  This way the receiving system on the other
  1535.         end knows what to do with the message.  When importing incoming  mail,
  1536.         messages with an AREA: tag TENNIS  will  be  put  in  the  TENNISM.DEF
  1537.         file.
  1538.  
  1539.     ■   The area SYSOPS does not refer to an RBBS-PC MESSAGES file, but  to  a
  1540.         subirectory that  holds  FIDO  style  messages.   If  a  message  with
  1541.         AREA:SYSOPS  is  received,  it  will  be  moved  to  the  subdirectory
  1542.         C:\BINK\SYSOPS\, where it can be read by an appropriate message editor
  1543.         like MsgEd or Dutchie's Editor.  RBBSMail sees the difference  between
  1544.         RBBS-PC MESSAGES files and FIDO subdirectories by itself.  If RBBSMail
  1545.         finds that a message base is a real file, a RBBS-PC MESSAGES  file  is
  1546.         assumed.  If the message base is a subdirectory, RBBSMail  will  treat
  1547.         the conference as a FIDO style message subdirectory.
  1548.  
  1549.     ■   You can probably figure out by yourself what happens to the other  two
  1550.         conference files RBBS-PC and IBM-PC? Well, sort of......
  1551.  
  1552.     There are two special cases in this example of AREAS.BBS, the WINDOWS  and
  1553.     the XMODEM area.  They are listed  using  the  same  message  subdirectory
  1554.     C:\BINK\PASSTHRU\.  This may look like mixing up  two  entirely  different
  1555.     echomail conferences, but it isn't.  If RBBSMail finds  that  an  echomail
  1556.     uses the special subdirectory  PASSTHRU,  it  will  normally  process  all
  1557.     messages for that area.  All checking for proper  control  echomail  lines
  1558.     will be performed, but a local copy of the message will never be  written.
  1559.     The echomail is just "passing through" and does not actually exist on  the
  1560.     local  system.   An  empty  subdirectory  \PASSTHRU  is  needed  for  this
  1561.     feature.
  1562.     This comes in quite handy if a system is forwarding  echomail  for  others
  1563.     because it has a cheap phone line or  has  cheap  calls  to  two  or  more
  1564.  
  1565.  
  1566.     Installation                                                            24
  1567.  
  1568.  
  1569.  
  1570.                                  RBBSMail v18.2
  1571.  
  1572.  
  1573.     neighbouring telephone districts.
  1574.  
  1575.     By default, RBBSMail will force all incoming and outgoing messages in  all
  1576.     conferences to  be  PUBLIC  messages,  except  for  private  messages  and
  1577.     comments to sysop.  However, you may add a '+', a '-' or a '!' directly in
  1578.     front of the area name, to change this default behaviour.
  1579.     The line defining the TENNIS conference includes a '+' telling RBBSMail to
  1580.     allow import and export of private messages.
  1581.     The line defining the IBM-PC conference includes a '-'  in  front  of  the
  1582.     area name, which tells RBBSMail  to  discard  all  messages  that  have  a
  1583.     message attribute of Private.
  1584.     The '!' in front of the area name WINDOWS tells RBBSMAil that  this  is  a
  1585.     read only area.  This means that incoming messages  will  be  imported  so
  1586.     users on your system can read them.  They  can  even  enter  replies,  but
  1587.     their  messages  will  never  be  exported  to  other  systems.   This  is
  1588.     especially useful in case one or more areas on your system are troubled by
  1589.     misbehaving users or when you decide to take a new echomail area for  just
  1590.     a trial period.
  1591.  
  1592.     This example has all your Echomail information in one file.  You may  have
  1593.     different AREAS.BBS-type files with different names and  different  Origin
  1594.     lines.  For instance, you could have a TENNIS.BBS file like:
  1595.  
  1596.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1597.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 512/10.2 8:926/1 2:9999/1
  1598.  
  1599.     Or an IBMPC.BBS file with:
  1600.  
  1601.       The Tennis Court, IBM PC Tech support, The Netherlands ! John Software
  1602.       C:\RBBS\IBMPCM.DEF -IBM-PC  2:512/1 2 3 12 8:926/1
  1603.  
  1604.     When you invoke RBBSMail SCAN explicitly giving  TENNIS.BBS  or  IBMPC.BBS
  1605.     (see  next  chapter)  it  will  take  the  sysop  name,  Origin  line  and
  1606.     distribution info from that file.  This way, you can put different  things
  1607.     in your Origin line and process Echomail  conferences  separately  and  at
  1608.     different times.
  1609.  
  1610.  
  1611.     4.3  Special AREA: names
  1612.  
  1613.  
  1614.     4.3.1  The OVERFLOW area
  1615.  
  1616.     RBBSMail  normally  dumps  messages  it  can't   toss   to   the   NETMAIL
  1617.     subdirectory.  This, for instance, happens if one  of  the  RBBS-PC  style
  1618.     conferences fills up.  If so, additional messages for that conference will
  1619.     clutter the NETMAIL subdir.  If the special area name OVERFLOW is  defined
  1620.     in AREAS.BBS, RBBSMail will dump messages for  overflowed  conferences  in
  1621.     that subdir.  This keeps your NETMAIL subdir clean.
  1622.  
  1623.     When RBBSMail fires up, the overflow area is always processed first,  thus
  1624.     ensuring that any leftovers are tossed before newly arrived  messages  are
  1625.     processed.
  1626.     To define the OVERFLOW special area, simply add a line  describing  it  to
  1627.  
  1628.  
  1629.     Installation                                                            25
  1630.  
  1631.  
  1632.  
  1633.                                  RBBSMail v18.2
  1634.  
  1635.  
  1636.     your AREAS.BBS file:
  1637.  
  1638.       C:\BINK\OVERFLOW        OVERFLOW
  1639.  
  1640.  
  1641.     Note: The OVERFLOW area MUST be a subdir, it cannot  be  a  RBBS-PC  style
  1642.     message base.
  1643.  
  1644.  
  1645.     4.3.2  The XNETMAIL area
  1646.  
  1647.     Optionally you can have one RBBS-PC  style  conference  assigned  to  hold
  1648.     copies of all incoming netmail that isn't addressed to Sysop.  While  this
  1649.     still doesn't allow the users of your BBS to communicate via netmail  from
  1650.     within RBBS-PC, your users will  at  least  be  able  to  receive  netmail
  1651.     addressed to them.  This conference may either be your MAIN  message  base
  1652.     or a separate conference.
  1653.  
  1654.     To have all incoming netmail copied to a RBBS-PC style conference,  simply
  1655.     add a line describing the conference to your AREAS.BBS file:
  1656.  
  1657.       C:\RBBS\NETMAILM.DEF    XNETMAIL
  1658.  
  1659.  
  1660.     Note: The NETMAIL area MUST be a subdir, it  cannot  be  a  RBBS-PC  style
  1661.     message base.
  1662.  
  1663.  
  1664.     4.4  Embedded commands in AREAS.BBS
  1665.  
  1666.  
  1667.     The AREAS.BBS file  may  contain  embedded  commands  to  perform  special
  1668.     functions on one or more echomail areas listed in AREAS.BBS.
  1669.  
  1670.     Remember that some Embedded commands are "sticky", which means  that  THEY
  1671.     WILL REMAIN VALID FOR ALL  AREA  DEFINITIONS  LISTED  AFTER  THE  EMBEDDED
  1672.     COMMAND OR UNTILL  A  NEXT  EMBEDDED  COMMAND  OVERRIDES/RESETS  THE  LAST
  1673.     SETTING.
  1674.  
  1675.     Embedded commands that are NOT sticky are ONLY VALID FOR  THE  FIRST  AREA
  1676.     DEFINITION FOLLOWING THE NON STICKY EMBEDDED COMMAND.
  1677.  
  1678.     All embedded commands consist of a dash ('-'), immeditely followed by  the
  1679.     command and optionally followed by one or more arguments.
  1680.  
  1681.  
  1682.     4.4.1  -Margin
  1683.  
  1684.     (Sticky) Set right hand message margin.  This tells RBBSMail at what  line
  1685.     length it should wrap messages imported to all RBBS-PC  style  conferences
  1686.     listed after this embedded command.  Valid margin is any value from 30  to
  1687.     72.  If not specified, margin defaults to 72 characters.  Example:
  1688.  
  1689.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1690.  
  1691.  
  1692.     Installation                                                            26
  1693.  
  1694.  
  1695.  
  1696.                                  RBBSMail v18.2
  1697.  
  1698.  
  1699.       -Margin 72
  1700.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 9999/1 2 8:926/1
  1701.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1702.       -Margin 40
  1703.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1704.  
  1705.     This example will set a right hand margin of 72 for all messages  imported
  1706.     to the TENNISM.DEF and  IBMPCM.DEF  conferences,  while  messages  in  the
  1707.     RBSM.DEF conference will have a right hand margin of 40.
  1708.  
  1709.     If you set a margin valueof less than 72, it is advised to also  configure
  1710.     StripSeen in RBBSMAIL.CFG.  SEEN-BY lines in incoming messages  will  also
  1711.     be wordwrapped and this may interfere with the setting of RBBS-PC's CONFIG
  1712.     option 158.
  1713.  
  1714.     Note: This embedded command does not affect FIDO style message bases.
  1715.  
  1716.  
  1717.     4.4.2  -MaxLines
  1718.  
  1719.     (Sticky) The maximum number of lines a message  may  contain  when  it  is
  1720.     imported to a RBBS-PC style message base.   If  a  message  contains  more
  1721.     lines than -MaxLines, RBBSMail will split the original message  and  store
  1722.     it as two or more separate messages.  The value of -MaxLines  can  be  set
  1723.     from 5 to 99.  If not specified, a default value of 70 is used.  Example::
  1724.  
  1725.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1726.       -MaxLines 20
  1727.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 512/10.2 9999/1 8:926/1
  1728.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1729.       -MaxLines 55
  1730.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1731.  
  1732.     This example will  cut  all  messages  imported  to  the  TENNISM.DEF  and
  1733.     IBMPCM.DEF conferences to messages of  20  lines  maximum.   All  messages
  1734.     written to the RBSM.DEF conference  will  have  a  maximum  length  of  55
  1735.     lines.
  1736.  
  1737.     Note: This embedded command does not affect FIDO style message bases.
  1738.  
  1739.  
  1740.     4.4.3  -Notify
  1741.  
  1742.     (Sticky) Notify users of unread mail.  If an imported message is addressed
  1743.     to a name that is in the  conference's  USERS  file,  then  this  person's
  1744.     mail_waiting flag will be set.  The user will then be notified of new mail
  1745.     next time he/she logs on to the system.
  1746.     Default is to always notify users of new mail.
  1747.  
  1748.     Note: This embedded command does not affect FIDO style message bases.
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.     Installation                                                            27
  1756.  
  1757.  
  1758.  
  1759.                                  RBBSMail v18.2
  1760.  
  1761.  
  1762.     4.4.4  -NoNotify
  1763.  
  1764.     (Sticky) Do not scan USERS files and do not set the mail_waiting flag.
  1765.  
  1766.     Note: This embedded command does not affect FIDO style message bases.
  1767.  
  1768.  
  1769.     4.4.5  -ExportComments
  1770.  
  1771.     (Sticky)  Normally,  Comments  and  Private  messages  to   Sysop   aren't
  1772.     exported.  In case you have a co-sysop running as one of your  points,  he
  1773.     may wish to see comments and private messages to sysop as well.   You  can
  1774.     tell RBBSMail to export comments and private messages to sysop  with  this
  1775.     embedded command.
  1776.  
  1777.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1778.       -ExportComments
  1779.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 10.2 9999/1 8:926/1
  1780.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1781.       -NoExportComments
  1782.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1783.  
  1784.     The example above tells RBBSMail to export  comments  to  sysop  from  the
  1785.     TENNIS and IBM-PC conferences, but not from the RBBS-PC conference.
  1786.  
  1787.     Note: Be warned that potentially ANYONE  can  read  whatever  confidential
  1788.     info in messages and comments to sysop once  the  message  has  left  your
  1789.     system!!
  1790.  
  1791.  
  1792.     4.4.6  -NoExportComments
  1793.  
  1794.     (Sticky) This embedded command tells RBBSMail NOT to  export  comments  to
  1795.     sysop from conferences.  This setting is the default.
  1796.  
  1797.  
  1798.     4.4.7  -Security
  1799.  
  1800.     (Sticky) The security level imported messages are set to.  A user  has  to
  1801.     have at least this access level to read any  imported  Echomail.   Ignored
  1802.     for messages in FIDO style message subdirectories.
  1803.     If no embedded -Security command is listed,  the  value  will  be  set  to
  1804.     whatevet value was  given  with  the  Security  configuration  phrease  in
  1805.     RBBSMAIL.CFG.  If neither the -Security embedded command not the  Security
  1806.     configuration phrase  is  given,  message  security  will  default  to  5.
  1807.     Example:
  1808.  
  1809.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1810.       -Security 3
  1811.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 10/2 9999/1 8:926/1
  1812.       -Security 5
  1813.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1814.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1815.  
  1816.  
  1817.  
  1818.     Installation                                                            28
  1819.  
  1820.  
  1821.  
  1822.                                  RBBSMail v18.2
  1823.  
  1824.  
  1825.     This example causes RBBSMail to set the message  security  to  3  for  all
  1826.     messages imported to the TENNISM.DEF conference.  Messages imported to the
  1827.     IBMPCM.DEF and RBBSM.DEF conferences will be set to a  security  level  of
  1828.     5.
  1829.  
  1830.     See also the Security configuration phrase.
  1831.  
  1832.     Note: This embedded command does not affect FIDO style message bases.
  1833.  
  1834.  
  1835.     4.4.8  -Slack & -MsgAge
  1836.  
  1837.     (Sticky) If, during mail import, RBBSMail finds that  a  RBBS-PC  messages
  1838.     file contains more messages than the number of messages set with  CONFIG's
  1839.     option 166, RBBSMail will automatically invoke RBBSMNT to  purge  messages
  1840.     from that messages file.
  1841.     If a messages file fills up, purging  it  down  to  the  exact  amount  of
  1842.     maximum messages would cause RBBSMail to call RBBSMNT  every  time  a  new
  1843.     message is imported to that the messages file.  To prevent this,  you  may
  1844.     specify a Slack value to make extra room in he messages file.
  1845.     If you specify Slack 50, RBBSMail will tell RBBSMNT to purge  50  messages
  1846.     from a conference file in case it fills up.  Importing to that  conference
  1847.     means that RBBSMNT may be invoked after every 50 imported messages.
  1848.     Messages older than MsgAge (in  days)  will  be  purged  first.   If  that
  1849.     doesn't cut the amount of active messages down enough, additional messages
  1850.     will be purged untill the total amount of messages is down to a  value  of
  1851.     calculated by the formula "Maximum_Messages minus Slack".
  1852.     The default values are 50 for Slack and 30 for MsgAge.
  1853.  
  1854.     Example of Slack and MsgAge usage:
  1855.  
  1856.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1857.       -Slack 50
  1858.       -MsgAge 21
  1859.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 10/2 9999/1 8:926/1
  1860.       -Slack 300
  1861.       -MsgAge 10
  1862.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1863.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1864.  
  1865.     This tells RBBSMail to call RBBSMNT and purge all messages older  than  21
  1866.     days from the TENNISM.DEF file in case it fills up.  If there isn't enough
  1867.     room left after purging by age, RBBSMNT will continue purging  untill  the
  1868.     proper amount of active messages  (i.e.   Maximum_Messages  minus  50)  is
  1869.     reached.
  1870.  
  1871.     If the IBMPCM.DEF or RBBSM.DEF file  fills  up,  messages  will  first  be
  1872.     deleted by age (10 days) and,  if  needed,  additional  messages  will  be
  1873.     purged untill the proper amount  (i.e.   Maximum_Messages  minus  300)  is
  1874.     reached.
  1875.  
  1876.     Ideally, the value for Slack should  be  a  little  above  the  number  of
  1877.     messages you expect to import to each conference during a  single  run  of
  1878.     RBBSMail.  This  is  hard  to  guess,  so  review  your  RBBSMail  logfile
  1879.  
  1880.  
  1881.     Installation                                                            29
  1882.  
  1883.  
  1884.  
  1885.                                  RBBSMail v18.2
  1886.  
  1887.  
  1888.     periodically to figure out how often RBBSMail invokes RBBSMNT.  If RBBSMNT
  1889.     is called too often for a  particular  conference,  use  RBBS-PC's  CONFIG
  1890.     program to increase the maximum number of messages for that conference and
  1891.     either increase the Slack value or decrease the value for MsgAge  in  your
  1892.     AREA.BBS file.
  1893.  
  1894.     See also the DynaPurge configuration phrase.
  1895.  
  1896.     Note: You must have a copy of RBBSMNT.EXE, in the current subdirectory  or
  1897.     in a subdirectory that  is  listed  in  your  PATH  environment  variable.
  1898.     RBBSMail requires RBBSMNT v2.10 or later.
  1899.  
  1900.     Note: This embedded command does not affect FIDO style message bases.
  1901.  
  1902.  
  1903.     4.4.9  -OrgAddress
  1904.  
  1905.     (NOT sticky) This embedded command overrides the originating  address  for
  1906.     the  next  area  definition.   This  allows  you  to  export  "Zone/Domain
  1907.     specific" echomail areas.
  1908.     Assuming  your  primary  address  is  2:512/10.0@fiodonet,  all   messages
  1909.     exported   from   system   will   carry   a   MSGID   in   the   form   of
  1910.     "2:512/10.0@fiodonet <serialnum>" and the address in the "* Origin:"  will
  1911.     be "2:512/10.0".
  1912.     In other words, messages exported from your  system  will  appear  to  the
  1913.     outside world as being sent from node 2:512/10.0@fiodonet
  1914.  
  1915.     If your system paticipates in multiple networks and you carry an  echomail
  1916.     conference for one specific network only,  you  probably  wnat  your  node
  1917.     address for THAT network to appear in the MSGID and " * Origin:" lines.
  1918.     Let's say your address in the other network is 8:998/1.0@rbbsnet  and  you
  1919.     have an AREA:RBBSMAIL that is only exchanged with systems on Zone  8.   By
  1920.     defining the area in your AREAS.BBS as:
  1921.  
  1922.         -OrgAddress  8:998/1.0@rbbsnet
  1923.         C:\RBBS\RBBSMM.DEF  RBBSMAIL 8:926/1
  1924.  
  1925.     all messages exported from this area will appear to the outside  world  as
  1926.     if they were sent by node 8:998/1.0@rbbsnet.
  1927.  
  1928.     The -OrgAddress  embedded  command  provides  complete  logical  isolation
  1929.     between echomail areas on your system.
  1930.  
  1931.     Note: You must also have "Address 8:998/1.0@rbbsnet" listed as one of your
  1932.     secondary addresses in RBBSMAIL.CFG.
  1933.  
  1934.     Note: The -OrgAddress enmbedded command is NOT sticky.
  1935.  
  1936.  
  1937.     4.4.10  -Password
  1938.  
  1939.     This is a special embedded command that has nothing to  do  with  the  way
  1940.     RBBSMail handles message  areas.   Th  -Password  embedded  command  is  a
  1941.     security feature which allows you  to  password-protect  the  exchange  of
  1942.  
  1943.  
  1944.     Installation                                                            30
  1945.  
  1946.  
  1947.  
  1948.                                  RBBSMail v18.2
  1949.  
  1950.  
  1951.     mailbundles between your system and others.
  1952.     The proper format of the -Password embedded command is:
  1953.  
  1954.         -Password 2:512/10.0 phunny
  1955.  
  1956.     Configuring a password for a destination address will  cause  RBBSMail  to
  1957.     write a password in all outgoing mailbundles to  that  address.   RBBSMail
  1958.     will also check for a password match on all mailbundles arriving from that
  1959.     address.  If the password in an incoming mailbunlde is missing or  doesn't
  1960.     match, RBBSMail refuses to process that mailbundle.
  1961.  
  1962.     This password scheme, together with RBBSMail's  securemail  option  and  a
  1963.     session password for your frontend mailer, allows for secure  exchange  of
  1964.     echomail.  For this to work properly, both sides  need  to  use  the  same
  1965.     password for their mail exchange  session  and/or  mailbundle  protection.
  1966.     The mailbundle password need not be the same as the session password  used
  1967.     by your frontend mailer.
  1968.  
  1969.     The mailbundle password has a  maximum  length  of  8  characters  and  is
  1970.     case-insensitive.
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.     Installation                                                            31
  2008.  
  2009.  
  2010.  
  2011.                                  RBBSMail v18.2
  2012.  
  2013.  
  2014.     5. Running RBBSMail
  2015.  
  2016.  
  2017.     Beginning with version 18.0, a number of safeguards  have  been  build  in
  2018.     RBBSMail to ensure RBBS-PC MESSAGES file integrity while TOSSing mail into
  2019.     RBBS-PC style conferences.  You do not need to bring down all  your  nodes
  2020.     when running RBBSMail.  You can have users reading  and  writing  messages
  2021.     on-line while at the same  have  RBBSMail  handle  incoming  and  outgoing
  2022.     echomail.
  2023.  
  2024.     There is one requirement to maintain message  base  integrity.   Configure
  2025.     the config phrase "Elastic".  Then, using RBBS-PC's  CONFIG  program,  set
  2026.     the option "Message file grows as messages  are  added"  to  YES  and  the
  2027.     "Maximum number of messages per conference" must be set to 999.
  2028.     OR
  2029.     Comment out the config phrase "Elastic" and use RBBS-PC's  config  program
  2030.     to set "Message file grows as messages  are  added"  to  NO  and  set  the
  2031.     "Maximum number of messages per conference" to a value less than 999.
  2032.  
  2033.     Unlike previous versions of RBBSMail, version 18.x imports and exports all
  2034.     echomail in ONE  single  sweep.   There's  no  need  to  specifically  run
  2035.     RBBSMail TOSS or RBBSMail SCAN.  Also, the MAINT mode of RBBSMail has been
  2036.     removed, there is now a separate program  RBBSMNT  to  do  maintenance  on
  2037.     RBBS-PC's messages files.
  2038.  
  2039.  
  2040.     5.1  Commandline options
  2041.  
  2042.  
  2043.     5.1.1  -A <areasbbsfile>
  2044.  
  2045.     Use an alternate areas listing.  RBBSMail defaults to AREAS.BBS (i.e.   -A
  2046.     AREAS.BBS).
  2047.  
  2048.  
  2049.     5.1.2  -AKA #
  2050.  
  2051.     Use # of AKA addresses (# is a number from 1 to 10).  This tells  RBBSMail
  2052.     to put '#' of your AKA addresses in the  SEEN-BY:  lines.   Addresses  are
  2053.     counted from top to bottom in your RBBSMAIL.CFG file.  The  first  address
  2054.     is used as your primary address, subsequent ADDRESS phrases are treated as
  2055.     AKA addresses.  RBBSMail uses no AKA addresses by default.
  2056.  
  2057.  
  2058.     5.1.3  -BM
  2059.  
  2060.     This switch tells RBBSMail to import messages from the BAD_MSGS area.   If
  2061.     you connected a new echomail area but did not create  that  area  on  your
  2062.     system or list it in your AREAS.BBS file, then RBBSMail will toss messages
  2063.     for that area to your BAD_MSGS subdirectory.
  2064.     Instead of manually moving these messages to your  netmail  directory  and
  2065.     importing them after you've created the appropriate area, just create  the
  2066.     area, list it in your AREAS.BBS and run RBBSMail -BM to import the  failed
  2067.     messages.  Copies  of  duplicates  messages  in  your  BAD_MSGS  directory
  2068.  
  2069.  
  2070.     Running RBBSMail                                                        32
  2071.  
  2072.  
  2073.  
  2074.                                  RBBSMail v18.2
  2075.  
  2076.  
  2077.     (stored there for later inspection) will  NOT  be  tossed  if  using  this
  2078.     commandline switch.  If you DO want to toss duplicate messages,  you  need
  2079.     to edit them manually.  THIS IS NOT AT ALL RECOMMENDED!!!.
  2080.  
  2081.     See also the KeepDups configuration phrase.
  2082.  
  2083.  
  2084.     5.1.4  -C <configfile>
  2085.  
  2086.     The -C: switch allows you to use <configfile> as  alternate  configuration
  2087.     file.  Default is RBBSMAIL.CFG (i.e.  -C RBBSMAIL.CFG)
  2088.  
  2089.  
  2090.     5.1.5  -FA
  2091.  
  2092.     Send outgoing  echomail  as  FileAttached  ARCmail.   This  switch  forces
  2093.     RBBSMail to build compressed mailbundles and  a  FilAttach  message.   Use
  2094.     this option  if  your  frontend  mailer  does  NOT  use  oMMM  as  message
  2095.     packer/router.
  2096.  
  2097.     The FileAttach messages can  then  be  processed  by  the  frontend's  own
  2098.     message router.  This  method  is  recommended  if  RBBSMail  is  used  in
  2099.     combination with Dutchie, SEAdog, Frontdoor or Intermail and allows points
  2100.     to be addressed by their 4-dimensional address.
  2101.     This  option  disregards  the  external  mailpacker  and  uses  RBBSMail's
  2102.     internal ARcmail handler.
  2103.  
  2104.     See also the MaxOut, PACK and ARCmail configuration phrases.
  2105.  
  2106.     Note: NEVER change the status of the FileAttach messages  RBBSMail  writes
  2107.     in your netmail subdirectory.  These messages are used by RBBSMail to keep
  2108.     track of sent and unsent ARCmail bundles and  should  not  be  changed  or
  2109.     deleted, except by your frontedn mailer when has actually sent the ARCmail
  2110.     bundle.
  2111.  
  2112.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  2113.  
  2114.  
  2115.     5.1.6  -H
  2116.  
  2117.     Use the FTS-0001 approved Ctrl-A kludge to hide the  SEEN-BY  lines.   For
  2118.     compatability only, NOT AT ALL recommended for real life use.
  2119.  
  2120.  
  2121.     5.1.7  -I
  2122.  
  2123.     Process INBOUND mail only.  This commandline switch tells RBBSMail that it
  2124.     should only process the incoming mailbundles for import/export, but not to
  2125.     export messages that were entered locally.  This option especially  useful
  2126.     on echomail backbones and passthru nodes that receive echomail all through
  2127.     the day, but have little or no messages entered locally.
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.     Running RBBSMail                                                        33
  2134.  
  2135.  
  2136.  
  2137.                                  RBBSMail v18.2
  2138.  
  2139.  
  2140.     5.1.8  -KN
  2141.  
  2142.     Kill all messages without human readable contents.
  2143.     See also the KillNull configuration phrase.
  2144.  
  2145.  
  2146.     5.1.9  -OB
  2147.  
  2148.     Build Outbound Bundles.  This forces RBBSmail to write  outgoing  echomail
  2149.     in  the  HOLD  subdirectory  as  oMMM/Binkley/Opus  compatbile  .OUT  type
  2150.     mailbundles.  A suitable mailpacker like oMMM can be used at a later  time
  2151.     to pack and route the outgoing mail.  This method is suitable for use with
  2152.     BinkleyTerm, and will  properly  address  points  by  their  4-dimensional
  2153.     addressing.
  2154.     See also the MaxOut and PACK configuration phrases.
  2155.  
  2156.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  2157.  
  2158.  
  2159.     5.1.10  -OF
  2160.  
  2161.     Build outbound FLO files like  oMMM  does.   After  writing  the  outgoing
  2162.     echomail as .OUT mailbundles, RBBSMail compresses the bundles  and  writes
  2163.     oMMM/Binkley compatible FLO files to the outbound subdirectory.   The  FLO
  2164.     files are used by Binkley to determine where to send the mailbundles.  The
  2165.     status of FLO files can be handled manually or automatically  by  oMMM  or
  2166.     AMAX.
  2167.  
  2168.     This method is suitable  for  use  with  BinkleyTerm,  and  will  properly
  2169.     address points by their 4-dimensional addressing.
  2170.     See also the MaxOut, PACK and ARCmail configuration phrases.
  2171.  
  2172.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  2173.  
  2174.  
  2175.     5.1.11  -OP
  2176.  
  2177.     Build Outbound Packets.  This commandline switch causes RBBSMail to  write
  2178.     outgoing  echomail  as  SEAdog  compatible  .PKT   files   in   the   Hold
  2179.     subdirectory.  The bundles may then be processed at  a  later  time  by  a
  2180.     suitable packer/router.  With a suitable mailer supporting FSC-00039, this
  2181.     method can be used to address points by their 4-dimensional address.
  2182.  
  2183.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  2184.  
  2185.  
  2186.     5.1.12  -P
  2187.  
  2188.     Protect  bundles.   Normally,  after  RBBSMail  uncompresses  and  unpacks
  2189.     incoming mailbundles, the bundles  are  deleted.   In  some  cases,  other
  2190.     programs may wish to do something with the incoming mailbundles too.   The
  2191.     -P  commandline  option  causes  RBBSmail  uncompress   and   unpack   the
  2192.     mailbundles normally, but it leaves all processed bundles intact.
  2193.  
  2194.  
  2195.  
  2196.     Running RBBSMail                                                        34
  2197.  
  2198.  
  2199.  
  2200.                                  RBBSMail v18.2
  2201.  
  2202.  
  2203.     The program  processing  the  bundles  left  by  RBBSMail  should  be  run
  2204.     IMMEDITATELY after RBBSMail is done.  If not, there  may  be  old  bundles
  2205.     left at the next run of RBBSMail, causing the same bundles to be  unpacked
  2206.     againwhich causes detection of a massive bulk of duplicate messages.
  2207.  
  2208.  
  2209.     5.1.13  -S
  2210.  
  2211.     Operate in secure mode.  This forces RBBSMail to check that  all  incoming
  2212.     echomail is originating from an addess that is listed in AREAS.BBS.  If an
  2213.     echomail message is received from an address that is  NOT  listed  in  the
  2214.     distribution list for that area, the message is  tossed  in  the  BAD_MSGS
  2215.     subdirectory.  Optionally, a copy of the offending message is returned  to
  2216.     the originator, with a short explanation.  message
  2217.     See also the SecureMail and NoRts configuration phrases.
  2218.  
  2219.  
  2220.     5.1.14  -T
  2221.  
  2222.     Use Tiny SEEN-BY  lines.   This  will  force  RBBSMail  to  put  only  the
  2223.     addresses from the AREAS.BBS distribution list in the SEEN-BY lines.   Use
  2224.     with extreme care, tiny SEEN-BY lines have been known to  cause  duplicate
  2225.     messages in networks that suffer from circular distribution of echomail.
  2226.  
  2227.  
  2228.     5.1.15  -X
  2229.  
  2230.     Exclude processing of the netmail subdirectory.  This forces  RBBSMail  to
  2231.     look for  incoming  echomail  as  mailbundles  or  ARCmail  bundles  only.
  2232.     Greatly speeds up the import of incoming mail.
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.     Running RBBSMail                                                        35
  2260.  
  2261.  
  2262.  
  2263.                                  RBBSMail v18.2
  2264.  
  2265.  
  2266.     6. A word on echomail distribution
  2267.  
  2268.  
  2269.     When RBBSMail is invoked, it will  read  the  lines  of  RBBSMAIL.CFG  and
  2270.     AREAS.BBS.  If  there  are  distribution  lists  in  the  AREAS.BBS  file,
  2271.     RBBSMail first searches all echomail conferences (RBBS-PC  MESSAGES  files
  2272.     and FIDO style message bases) for new messages and sends copies  of  these
  2273.     messages to their destionations.
  2274.     RBBSMail does a few checks before it exports a message.  If the TO or FROM
  2275.     field of a message contains "SYSOP", it is replaced by the  sysops's  real
  2276.     name.  This hopefully prevents confusion about "what sysop the message  is
  2277.     addressed to?" when the message arrives on other systems.
  2278.  
  2279.     RBBS-PC  allows  users  of  the  BBS  to  enter  comments  to   SYSOP   in
  2280.     conferences.  If  the  SUBJECT  filed  of  a  message  contains  the  word
  2281.     "COMMENT", the message is not exported.
  2282.     Depending on the setting of '+' and '-' in AREAS.BBS, RBBSMail wil  ignore
  2283.     private messages, send them as-is or force them to be public messages.
  2284.  
  2285.     If a message contains NOECHO (just one word, in UPPER case) as  the  first
  2286.     line of the message text, RBBSMail will NOT send that message out  on  the
  2287.     network.  So, if there's anything to be said in  a  conference  that  only
  2288.     concerns users on YOUR system, put NOECHO as first line of the message and
  2289.     that message will not be send to other systems.  Inform your  users  about
  2290.     this feature!
  2291.  
  2292.     During the process of exporting messages, new messages will be tagged with
  2293.     an MSGID:  (Message  Identification)  tag  at  the  top  of  all  outgoing
  2294.     messages.  The MSGID: tag is a unique message  identifier  in  the  format
  2295.     MSGID: Z:N/N/P yyyyyyyy
  2296.  
  2297.       where:
  2298.       Z:N/N.P is your full Zone:Net/Node.Point address
  2299.       yyyyyyyy = a DOS style date&time marker.
  2300.  
  2301.     The date/time stamp plus the 16 bit CRC of the From, To and Subject fields
  2302.     of the message are used to generate an identifier  that  can  be  used  to
  2303.     check for duplicate messages.  Another identifier  is  stored  in  a  file
  2304.     named xxxx.DUP (where xxxx is the name of the current  conference).   This
  2305.     is a wrap around file, holding the IDs of the last incoming  and  outgoing
  2306.     echo messages for each area.
  2307.     The number of message IDs (and thus the size of the dups file) can be  set
  2308.     with the configuration phrase DupSize in RBBSMAIL.CFG.
  2309.  
  2310.     Next,  RBBSMAil  looks  for  incoming  mail  in  the  MAIL   and   NETFILE
  2311.     directories.  After checking for proper addressing and duplicate messages,
  2312.     RBBSMail will send a copy of the incoming messages to the destination list
  2313.     and then toss it to either the appropriate RBBS-PC conference  or  to  the
  2314.     proper FIDO style message subdirectory listed in AREAS.BBS.
  2315.     If there is no  RBBS-PC  conference  file  or  FIDO  message  subdirectory
  2316.     related to the AREA:tag, the message is tossed to the BAD_MSGS area.
  2317.  
  2318.     When importing mail, RBBSMail will look for a USERS file belonging to  the
  2319.     conference it writes any message to.  This USERS file is scanned  for  the
  2320.  
  2321.  
  2322.     A word on echomail distribution                                         36
  2323.  
  2324.  
  2325.  
  2326.                                  RBBSMail v18.2
  2327.  
  2328.  
  2329.     name the message is addressed  to.   If  the  name  is  found,  the  'mail
  2330.     waiting' bit for this user will be flipped ON.  If you use  the  new  mail
  2331.     notification or the [V]iew conferences feature of RBBS-PC (i.e.  you  have
  2332.     a CONFMAIL.DEF type file), users can quickly check for  new  mail  in  the
  2333.     conferences, without having to access each conference separately.
  2334.  
  2335.     Note: USERS file update only works for RBBS-PC  MESSAGES  files,  not  for
  2336.     FIDO style message subdirectories.
  2337.  
  2338.     Echomail messages addressed to net/node numbers other than  your  net/node
  2339.     number(s) are tossed to the BAD_MSGS directory.   NETmail  messages  (i.e.
  2340.     messages without an AREA:tag) are ignored and left intact in  the  NETMAIL
  2341.     directory.
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.     A word on echomail distribution                                         37
  2386.  
  2387.  
  2388.  
  2389.                                  RBBSMail v18.2
  2390.  
  2391.  
  2392.     7. A word on RBBS-PC MESSAGES files
  2393.  
  2394.  
  2395.     7.1  Filesizes
  2396.  
  2397.  
  2398.     When you installed RBBS-PC, it required you to tell it what the  size  (in
  2399.     128 byte records) of your MESSAGES files should be,  how  many  lines  per
  2400.     message you allow and what the maximum amount  of  active  messages  in  a
  2401.     particular MESSAGE file should be.  RBBSMail has its own ideas  about  the
  2402.     size of a message, so you should take a few precautions.
  2403.     Configure RBBS-PC to use MESSAGES files that grow as messages  are  added,
  2404.     and set the maximum  amount  of  messages  to  999.   RBBSMail  will  then
  2405.     automatically manage the size of the MESSAGES  files  for  you.   RBBSMail
  2406.     will always check the number of free records in any MESSAGES  file  before
  2407.     it starts processing that file.  If there is not sufficient room  left  to
  2408.     process the newly entered message in a MESSAGES file,  RBBSMail  will  not
  2409.     process the file.  If, for some reason, the MESSAGES file is  full  before
  2410.     the RBBSMail is done, the MESSAGES file will be expanded to ensure that no
  2411.     messages are lost.
  2412.  
  2413.     As there are no restrictions to  the  size  of  FIDONET  messages,  it  is
  2414.     possible that you receive mail with more lines per message than  you  have
  2415.     pre-set in RBBS-PC's CONFIG program.
  2416.  
  2417.     You should periodically review the behaviour of your MESSAGES files.   Kim
  2418.     Wells' MU-PURGE program shows statistics about the amount of used and free
  2419.     space in your MESSAGES files.
  2420.  
  2421.     Sometimes RBBSMail just hangs up in the middle of  a  SCAN  or  TOSS  run.
  2422.     This is usually caused by a broken link in the MESSAGES file.  A  possible
  2423.     reason for having your MESSAGES files messed up is that MU-PURGE choked on
  2424.     a message that was too big to process.  If you run MU-PURGE on a  MESSAGES
  2425.     file with a lot of *big* messages, MU-PURGE  will  sometimes  run  out  of
  2426.     memory and abort, leaving a broken chain in the MESSAGES file.
  2427.  
  2428.     It is therefore HIGHLY advised to set the SIZE parameter  in  RBBSMAIL.CFG
  2429.     to a value of 12000 or less.
  2430.  
  2431.     If the above happens, the most elegant way to recover is:
  2432.  
  2433.         - Use RBBS-PC's CONFIG program to repair the broken MESSAGES file.
  2434.         - Use RBBS-PC's CONFIG program to pack the MESSAGES file.
  2435.         - Start RBBS-PC and kill the first message in the  MESSAGES  file  you
  2436.         just repaired.
  2437.         - Decrease the value of the SIZE parameter in RBBSMAIL.CFG.
  2438.  
  2439.  
  2440.     7.2  Filenames for CONFERENCES
  2441.  
  2442.  
  2443.     Let's take the TENNIS conference from the  above  examples.   You  have  a
  2444.     TENNISM.DEF file that holds all the messages and a TENNISU.DEF  file  that
  2445.     holds all users of the TENNIS conference.  If you create a file TENNIS.ORG
  2446.  
  2447.  
  2448.     A word on RBBS-PC MESSAGES files                                        38
  2449.  
  2450.  
  2451.  
  2452.                                  RBBSMail v18.2
  2453.  
  2454.  
  2455.     in the same directory your  TENNISM.DEF  and  TENNISU.DEF  files  are  in,
  2456.     RBBSMail will take the FIRST line from this file and use it as the text in
  2457.     your Origin line.
  2458.     So,  for  all  conferences  or  subboards  on  your  system,  the   naming
  2459.     conventions should be:
  2460.  
  2461.     xxxxM.def the Messages file of conference with name 'xxxx'
  2462.     xxxxU.def the Users file of conference with name 'xxxx'
  2463.     xxxx.DUP  the file containing the IDs of messages already imported in this
  2464.               conference.  You  shouldn't  bother  with  this  file,  RBBSMail
  2465.               handles it for you.
  2466.     xxxx.ORG  the file  containing  the  text  of  the  Origin  line  for  the
  2467.               conference with filename 'xxxxM.DEF'
  2468.  
  2469.     For FIDO style message subdirectory,  a  file  named  DUPDATA.DAT  in  the
  2470.     subdirectory holds the IDs.
  2471.  
  2472.  
  2473.     7.3  Filenames for SUBBOARDS
  2474.  
  2475.  
  2476.     RBBS-PC allows any valid DOS filename  for  MESSAGE  and  USERS  files  in
  2477.     subboards.  By not using the standard RBBS-PC xxxxM.DEF naming convention,
  2478.     MESSAGES files are not accessible by the [J]oin conference command,  which
  2479.     is exactly what you want for a subboard.
  2480.     This poses a bit of a problem for RBBSMail, for it has no way of  figuring
  2481.     out the names of MESSAGE and  USERS  files  in  subboards,  execept  maybe
  2482.     reading the RBBSxPC.DEF files for each conference and/or subboard.  Due to
  2483.     the many changes of the RBBS-PC.DEF file in every new version of  RBBS-PC,
  2484.     this is highly unreliable.
  2485.  
  2486.     Therefore, RBBSMail uses the following convention for  MESSAGE  and  USERS
  2487.     files that are not named according to the standard RBBS-PC  xxxxM.DEF  and
  2488.     xxxxU.DEF method:
  2489.  
  2490.     ABCXYZ    the MESSAGES file of a subboard (NO extension!)
  2491.     ABCXYZ.USRthe USERS file of the subboard with ABCXYZ as MESSAGE file (.USR
  2492.               extension is mandatory!)
  2493.     ABCXYZ.DUPthe file  containing  the  IDs  of  messages  imported  in  this
  2494.               conference.  You  shouldn't  bother  with  this  file,  RBBSMail
  2495.               handles it for you.
  2496.     ABCXYZ.ORGthe file containing the  text  for  the  Origin  line  for  this
  2497.               subboard.
  2498.  
  2499.     In short:
  2500.     If your RBBS-PC MESSAGE and USERS files are named in the form of xxxxM.DEF
  2501.     with an accompanying xxxxU.DEF file, RBBSMail will strip  off  the  M.DEF,
  2502.     and ONLY the significant part of the MESSAGES file's filename  (i.e.   the
  2503.     conference name) will be  used  to  identify  the  xxxx.ORG  and  xxxx.DUP
  2504.     files.
  2505.     If your RBBS-PC MESSAGE and USERS files (for subboards) only consist of  a
  2506.     filename with no extension, the whole name of the files will  be  used  to
  2507.     identify xxxx.ORG and xxxx.DUP files.
  2508.  
  2509.  
  2510.  
  2511.     A word on RBBS-PC MESSAGES files                                        39
  2512.  
  2513.  
  2514.  
  2515.                                  RBBSMail v18.2
  2516.  
  2517.  
  2518.     7.4  Filenames for FIDO style subdirs
  2519.  
  2520.  
  2521.     In a FIDO style message subirectory, all messages are  in  separate  files
  2522.     with the extension '.MSG" (i.e.  message 1 will  be  1.MSG).   The  naming
  2523.     convention for FIDO style message bases differs somewhat  from  the  above
  2524.     method of naming files for RBBS-PC conferences and subboards.
  2525.  
  2526.     To have a separate text for the Origin  lines  in  a  FIDO  style  message
  2527.     subirectory, simply put a file with the name ORIGIN (no extension) in that
  2528.     particular subdirectory.  This is the equivalent  of  the  xxxx.ORG  files
  2529.     mentioned avbove.
  2530.  
  2531.     The IDs of imported messages are stored in  the  subdirectory  in  a  file
  2532.     named DUPDATA.DAT.  It is the equivalent of the xxxx.DUP  files  mentioned
  2533.     above.
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.     A word on RBBS-PC MESSAGES files                                        40
  2575.  
  2576.  
  2577.  
  2578.                                  RBBSMail v18.2
  2579.  
  2580.  
  2581.     8. How to set up your mail
  2582.  
  2583.  
  2584.     8.1  What you need
  2585.  
  2586.  
  2587.     To get your mail in and out on the FIDONET, you need  a  number  of  other
  2588.     programs and files.  (Assuming you already have RBBS-PC running):
  2589.  
  2590.     ■   Frontend mailer (BinkleyTerm, Dutchie or d'Bridge)
  2591.     ■   oMMM, mOOO or Packer, to pack up outgoing mailbundles
  2592.     ■   ARCA and ARCE or PKARC and PKXARC
  2593.     ■   If you  don't  want  RBBSMail  to  unpack  incoming  mailbundles,  use
  2594.         Confmail, QM  or  whatever  appropriate  program  to  unpack  incoming
  2595.         mailbundles.
  2596.     ■   A recent nodelist
  2597.     ■   PARSELST, a program to compile and update your nodelist
  2598.     ■   A mail-editor (Dutched or MSGED) to inspect incoming/outgoing mail  is
  2599.         strongly suggested.  It will be a great help getting started.
  2600.  
  2601.     First, you need to set up the frontend mailer  and  the  schedules.   Your
  2602.     local or regional HOST or HUB has to supply the times when you should call
  2603.     him to deliver and pick up your mail.  There is an extensive chapter about
  2604.     setting up schedules (or events) and routing in the documentation of  your
  2605.     frontend mailer.
  2606.     If you want to have control over your schedules  from  within  your  batch
  2607.     files (i.e.  outside the scheduler of your mail frontend), you may want to
  2608.     look at the program WDATIME that is included  in  this  package.   WDATIME
  2609.     enables you to test Month, Date, Time and Day of the Week from within your
  2610.     batch files.
  2611.  
  2612.     It is STRONGLY recommended to make arrangements with your HOST or  HUB  to
  2613.     have him forward the weekly NODELIST or NODEDIFF files, so  your  nodelist
  2614.     will always be up to date.  See PARSELST.DOC how to set  up  an  automatic
  2615.     update of your nodelist.
  2616.     If  your  HOST  or  HUB  carries  the  weekly  FIDO  newsletter  or  other
  2617.     newsletters of interest, ask him to forward it to you.  There is a lot  of
  2618.     useful information in some of these regular newsletters.
  2619.  
  2620.     After you set up your frontend mailer and your schedules, you are ready to
  2621.     run.
  2622.     Well, sort of.....  While setting up the events and the bulky  batch  file
  2623.     you need to run your system plus mailer, you should  also  stick  in  some
  2624.     lines containing the proper RBBSMail commands at the proper  places.   I'm
  2625.     afraid you are on your own on this, there is no boilerplate for  it.   You
  2626.     should at least run RBBSMail shortly BEFORE your main mail event  (usually
  2627.     the National Mail Hour) and AFTER the NMH.  If you run  mail  outside  the
  2628.     NMH, you can run RBBSMail as often as you may need for other events.
  2629.     Again, you have to decide on this in agreement with whatever other systems
  2630.     you exchange mail with.
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.     How to set up your mail                                                 41
  2638.  
  2639.  
  2640.  
  2641.                                  RBBSMail v18.2
  2642.  
  2643.  
  2644.     8.2  A quick overview
  2645.  
  2646.  
  2647.     1.  Run RBBSMail to export new messges from your system.
  2648.     2.  Run your mailpacker (oMMM, MOOO  or  whatever)  with  the  appropriate
  2649.         schedules and routings (contact your  host  for  the  routing).   Your
  2650.         outgoing mail is now ready to be sent.
  2651.     3.  Have your frontend mailer call all other  systems  you  exchange  mail
  2652.         with, or sit and wait for them to call you.
  2653.     4.  Run RBBSMail import/export the received Echomail.
  2654.     5.  You have now succesfully exchanged Echomail.  Congratulations!
  2655.  
  2656.  
  2657.     Note: If you have both FIDO/OPUS style messages  directories  AND  RBBS-PC
  2658.     MESSAGES files for your Echomail, you need TWO AREAS.BBS files IF you want
  2659.     the FIDO style conferences  to  be  processed  by  another  program.   For
  2660.     instance, you need an AREAS.BBS for ConfMail to process mail  to/from  the
  2661.     FIDO style subdirectories and an AREAS.BBS for RBBSMail  to  process  mail
  2662.     to/from the RBBS-PC MESSAGES files.  The  two  files  may  have  different
  2663.     names or may be located in different subdirectories.  You can NOT use  the
  2664.     same AREAS.BBS file for both ConfMail and RBBSMail.
  2665.  
  2666.  
  2667.     8.3  Enhanced Setup / CRITMON<tm>
  2668.  
  2669.  
  2670.     Either by using the -OrgAddress embedded command  or  by  using  different
  2671.     RBBSMAIL.CFG, AREAS.BBS and xxxx.ORG files, you can do CRITMON<tm>.   That
  2672.     is Creative Renaming In The Middle Of The Nigth.  You can  appear  to  the
  2673.     net as two or more completely different systems.  Or run as one system  in
  2674.     several different networks.  Or both.  Or send all your outbound  Echomail
  2675.     to yourself every night.  Or cross-link two of your echomail sources  with
  2676.     a circular feed.  Or receive Echomail as 123/1 and send  the  whole  bunch
  2677.     back to your host as 789/2, thus making a lot of "friends".
  2678.  
  2679.     Don't rush to your keyboard  to  do  CRITMON<tm>  right  away.   Remember,
  2680.     Personal Computers can be used Personally, programmed Personally  and  you
  2681.     can Personally screw the thing up beyond belief.  Like me, you are  likely
  2682.     to do the latter.....
  2683.  
  2684.     Sit down with a big sheet of paper, a pencil and a pencil  eraser.   Setup
  2685.     an overview of what you want your system to do and  where  you  send  mail
  2686.     to.  Figure out the setup of your config files  and  your  schedule(s)  of
  2687.     events.  Then, make ONE setup and test it.  up your system for ONE of  the
  2688.     alternatives and test it.  With another sheet of paper,  setup  the  other
  2689.     alternatives, and test them one by one.  In any case,  don't  change  more
  2690.     than one thing at a time in your setup.  FUBAR is the word!
  2691.  
  2692.     RBBSMail will (in most cases) do faithfully what you want, even  with  the
  2693.     craziest setup.  If it doesn't do what you want,  (or  it  DOES  what  you
  2694.     want) you have yourself to thank for it.
  2695.  
  2696.     Since most of the address translation is done  completely  transparent  by
  2697.     RBBSMail, you usually need just ONE setup.
  2698.  
  2699.  
  2700.     How to set up your mail                                                 42
  2701.  
  2702.  
  2703.  
  2704.                                  RBBSMail v18.2
  2705.  
  2706.  
  2707.     8.4  Cross-zone echomail / CRITMON<tm>
  2708.  
  2709.  
  2710.     If you are a node in more than one Zone, RBBSMAIL will be  quite  creative
  2711.     when CRITMONning.  For instance, you run as 2:512/10 in FIDONET Zone 2 and
  2712.     as 8:998/1 in RBBSNet.  You  have  will  have  addresses  in  RBBSMAIL.CFG
  2713.     listed as:
  2714.  
  2715.       Address 2:512/10
  2716.       Address 2:2/508
  2717.       Address 8:998/1
  2718.  
  2719.     and a line in your AREAS.BBS lik this one:
  2720.  
  2721.         C:\RBBS\CHATM.DEF  CHATTER 2:512/1 2:9999/1 8:998/10
  2722.  
  2723.     Now, RBBSMail will export messages to  2:512/1  (your  FIDONET  host),  to
  2724.     2:9999/1 (one of your 2D points)  and  to  8:998/1  (your  RBBSNet  host).
  2725.     RBBSMail's CRITMON will cause messages sent to 2:512/1.0 and 2:9999/1.0 to
  2726.     appear as if they were sent from 2:512/10.0, and the messages to  8:998/10
  2727.     will have sender address 8:998/1.0 in the message header and in  the  PATH
  2728.     line.  In other words, RBBSMail adjusts the originating address  and  PATH
  2729.     line of outgoing echomail messages so they match the address  you  use  in
  2730.     the destination zone.  This  way,  secure  echomail  distribution  accross
  2731.     zones will be possible and you don't have to bother with running different
  2732.     setups for sending echomail to different zones.
  2733.     The addresses listed in the * Origin line and the  MSGID  tag  will  carry
  2734.     your primary, unless you have specifically changed the origin address  via
  2735.     the -OrgAddress embedded command in your AREAS.BBS file.
  2736.  
  2737.     Please note that RBBSMail  will,  by  default,  put  either  your  PRIMARY
  2738.     address or the address specified at the -OrgAddress  embedded  command  in
  2739.     the SEEN-BY lines.  If you exchange mail with other systems using  one  of
  2740.     your alternate adresses, you must either use the -AKA  commandline  switch
  2741.     to tell RBBSMail to put one or more of your  alternate  addresses  in  the
  2742.     SEEN-BY line or configure a GATE phrase for those destination addresses.
  2743.  
  2744.     RBBSMail uses the same naming convention for  outbound  subdirectories  as
  2745.     BinkleyTerm and oMMM does.  If you have set your HOLD subdir like  in  the
  2746.     examples above, RBBSMail will write outbound echomail bundles addressed to
  2747.     any node in your own zone (in this  case,  zone  2)  to  the  subdirectory
  2748.     C:\BT\HOLD.
  2749.     For  each  additional  destination  zone,  RBBSMail   needs   a   separate
  2750.     directory.  The additional directories simply get an  extension  (Yeah,  I
  2751.     know, subdirectory names aren't supposed to have extensions).
  2752.     The 3-digit hexadecimal representation of the destination zone  number  is
  2753.     used as extension.   Following  the  above  exapmles,  all  outbound  mail
  2754.     addressed to  Zone  4  is  written  to  the  subdirectory  C:\BT\HOLD.004,
  2755.     outbound stuff for zone 30 ends up in a subdirectory named  C:\BT\HOLD.01E
  2756.     and mail for zone 69 will be written the C:\BT\HOLD.045 subdirectory.
  2757.  
  2758.     If you run RBBSMail in  combination  with  BinkleyTerm  and/or  oMMM,  you
  2759.     already have these additional subdirectories and they  will  automatically
  2760.     be  used  by  RBBSMail.   If  they  aren't  there,  RBBSMail  will  create
  2761.  
  2762.  
  2763.     How to set up your mail                                                 43
  2764.  
  2765.  
  2766.  
  2767.                                  RBBSMail v18.2
  2768.  
  2769.  
  2770.     additional subdirectories for outbound zones whenever it needs them.
  2771.  
  2772.     If you run RBBSMail with another frontend  mailer  than  BinkleyTerm,  you
  2773.     probably need to tell your mailer and/or mailpacker that it should look in
  2774.     the additional subdirectories for outbound mail to other  zones.   There's
  2775.     no need to bother about this if you use  the  -FA  commandline  switch  in
  2776.     combination with FrontDoor, SEADog or Dutchie.   The  FileAttach  messages
  2777.     created by RBBSMail will alwys end up in your NETmail directory, with  the
  2778.     proper drive, path and filename for the attached mailbundle.
  2779.  
  2780.  
  2781.     8.5  Network Gateway Systems
  2782.  
  2783.  
  2784.     The Public Amateur Computer Network, commonly known as FIDONET, used to be
  2785.     the only system of linked bulletin boards in the world.  For the last  few
  2786.     years, new FIDO  compatible  networks  have  popped  up.   There  now  are
  2787.     AlterNet, Turbo Data Net and RBBSNet, to name a few.
  2788.     These networks are completely independent structures,  but  lately  people
  2789.     started exchanging Echomail  between  these  networks.   This  poses  some
  2790.     political  and  operational  problems.   Politics  should   be   left   to
  2791.     politicians, so I will only deal with the operational stuff.
  2792.  
  2793.     Let me give an example to clarify  the  problems.   Suppose  a  system  in
  2794.     FIDONET Zone 2 wants to exchange Echomail with a  system  in  the  RBBSNet
  2795.     (which uses zone 8 for practical purposes) and pass it on to other systems
  2796.     in the FIDONET.  All Echomail received from the RBBSNet systems will  list
  2797.     an address in the Origin line that is not a valid FIDONET address.
  2798.     Just passing this netmail through will probably get a FIDONET  coordinator
  2799.     up the wall, for FIDONET does not  like  to  carry  around  messages  with
  2800.     invalid (non-FIDONET) addresses.  As the RBBSNet system will not be in the
  2801.     FIDONET NODELIST with his RBBSNet node number, his RBBSNet nodenumber will
  2802.     be invalid in FIDONET, so we need to do something about that.
  2803.  
  2804.     For instance, FIDO 2:2/508.0 serves as the  inbound  Network  Gateway  for
  2805.     Echomail from RBBSNet (which uses zone number 8) to FIDO zone 2.  All  (or
  2806.     most) Echomail received from RBBSNet will list zone  8  addresses  in  the
  2807.     Origin lines.  To fullfill the above FIDONET  requirements,  all  messages
  2808.     that are send out by 2:2/508.0 to other  FIDONET  systems  should  have  a
  2809.     valid Origin address in the Origin line.  RBBSMail will take care of  this
  2810.     in a simple manner.
  2811.     The INDOMAIN phrase in RBBSMAIL.CFG should list the (fake) ZONE number  of
  2812.     the other network for which your system is the Network Gateway,  plus  the
  2813.     Origin line to be added to messages from the other network.  On 2:2/508.0,
  2814.     the INDOMAIN statement would look like this:
  2815.  
  2816.       INDOMAIN 8 RBBSNetwork Gateway to Europe (2:2/508.0)
  2817.  
  2818.     A practical example: A message entered on RBBSNet 8:926/1.0 will have that
  2819.     address listed in the Origin line.  When 2:2/508.0 receives this  messages
  2820.     and sends it out to a system in a zone OTHER than zone 8, the Origin  line
  2821.     will be zapped and an extra Origin line  "RBBSNetwork  Gateway  to  Europe
  2822.     (2:2/508.0)" will be added to the messages.  This  fullfills  the  FIDONET
  2823.     requirement of valid addresses.
  2824.  
  2825.  
  2826.     How to set up your mail                                                 44
  2827.  
  2828.  
  2829.  
  2830.                                  RBBSMail v18.2
  2831.  
  2832.  
  2833.     The conversion will ONLY take place for messages  that  originate  from  a
  2834.     system in the zone listed in the "INDOMAIN" phrase AND if  those  messages
  2835.     are sent to a system that is not in that zone.  Messages that stay  within
  2836.     the same zone or messages that originate from other  zones  will  be  left
  2837.     untouched.
  2838.  
  2839.     Only one INDOMAIN network gateway can be  defined  (there  ain't  no  such
  2840.     thing as an outdomain).  One should exercise  great  care  in  setting  up
  2841.     systems like this.  Contact your network or  zone  coordinator,  agree  on
  2842.     terms and conditions for operating the Network Gateway.  Be sure to inform
  2843.     other systems about the proper routing for mail that has to  pass  through
  2844.     the network gateway.
  2845.  
  2846.     The above method is rather simple and somewhat crude, but it has  been  in
  2847.     operation at 2:2/508 since September 1988 without problems.
  2848.  
  2849.  
  2850.     8.6  Error determination
  2851.  
  2852.  
  2853.     Sometimes it looks as if you just can't get it right.   If  you  encounter
  2854.     problems with RBBSMail, step thru the following procedure to diagnose  the
  2855.     situation.
  2856.  
  2857.     1.  RTFM.
  2858.     2.  Check the configuration files for  typos,  incorrect  drive,  path  or
  2859.         filenames.  Check contents of AREAS.BBS.  Change if needed.
  2860.     3.  RTFM again.
  2861.     4.  Check the commandline for proper switches.  Change if needed.
  2862.     5.  Relax, have a cup of coffee and let the situation soak in for a while
  2863.     6.  Run the program again.
  2864.     7.  If the  symptoms  change,  repeat  the  above  steps  till  the  error
  2865.         'magically' disappears.
  2866.     8.  If the above steps fail, erase RBBSMail.LOG.
  2867.     9.  Run RBBSMail in the failing situation.
  2868.     10. Send me a CRASHmail  message  with  the  problem  properly  described.
  2869.         File-attach a copy of your setup files and a LOG file that  shows  the
  2870.         problem.  Feel free to include any other  relevant  information,  like
  2871.         type and version number of hardware and software you  use,  filesizes,
  2872.         AREAS.BBS and BINKLEY.CFG.   You  may  wish  to  include  examples  of
  2873.         failing messages or mailbundles.
  2874.     11. Poll my system after a few days to see if there's a reply for you.  If
  2875.         you have a real problem, and I'm not on  vacation,  there  will  be  a
  2876.         reply (and hopefully a fix) waiting.
  2877.     12. If there's no reply and I'm not on vacation, RTFM and repeat the above
  2878.         steps.
  2879.     13. Flames will never be dignified with an answer.
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.     How to set up your mail                                                 45
  2890.  
  2891.  
  2892.  
  2893.                                  RBBSMail v18.2
  2894.  
  2895.  
  2896.     8.7  Other stuff
  2897.  
  2898.  
  2899.     I'm sure you will have a lot of questions about Echomail.  It is a strange
  2900.     sort of animal to RBBS-PC sysops.  But, don't fear! Echomail  can  be  fun
  2901.     and can be a great enhancement to your system.  If, at  first,  you  don't
  2902.     understand what Echomail is all about, talk to a local OPUS or FIDO  sysop
  2903.     or to the sysop of the host in your local  network.   Sysops  are  strange
  2904.     birds, but very helpful and usually eager to show you around.  The  moment
  2905.     you have your Echomail running you'll see the benefits of it.
  2906.  
  2907.     If you decide to hook up your RBBS-PC system to the world of FIDONET,  you
  2908.     also  may  wish  to  take  part  in  several  RBBS-PC   related   Echomail
  2909.     conferences.  In the USA, contact your  local  host  system.   In  Europe,
  2910.     contact me by sending me a netmail message, and start polling for  mail  a
  2911.     few days later.
  2912.  
  2913.     And there are several Echomail  conferences  about  the  frontend  mailers
  2914.     BINKLEY (for BinkleyTerm), WINDMILL (for Dutchie) and FD (for  FrontDoor).
  2915.     If a local or regional HOST or  HUB  carries  a  conference  on  the  mail
  2916.     frontend you use, make arrangements to get the echo.  It will be of  great
  2917.     help to you.
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.     How to set up your mail                                                 46
  2953.  
  2954.  
  2955.  
  2956.                                  RBBSMail v18.2
  2957.  
  2958.  
  2959.     9. The RBBSNet
  2960.  
  2961.  
  2962.     Several RBBS-PC sysops have started  a  RBBSNet,  separate  from  FIDONET.
  2963.     Currently, there are a bunch of FIDO  compatible  networks  in  operation:
  2964.     FIDONET, EggNet, The People's Net, AlterNet, TuboDatanet and GT-Net.   I'm
  2965.     part of both FIDONET and RBBSNet, and my system is  the  European  gateway
  2966.     for RBBSNet (node 8:998/1.0  in  the  RBBSNet).   For  more  info  on  the
  2967.     RBBSNet, Contact Rod Bowman of the PC-Spectrum RBBS in Alta  Loma,  CA  at
  2968.     (714) 945-2612.  Rod has put an enormous amount of work in setting up  the
  2969.     RBBSNet.  I sure hope it will all work out.
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.     The RBBSNet                                                             47
  3016.  
  3017.  
  3018.  
  3019.                                  RBBSMail v18.2
  3020.  
  3021.  
  3022.     10. Future enhancements
  3023.  
  3024.  
  3025.     10.1  Planned for new releases
  3026.  
  3027.  
  3028.     In order of priority:
  3029.  
  3030.     1.  Addition of NetBrick<tm> feature.
  3031.     2.  Addition of zone-aware netmail subdirectories.
  3032.     3.  Addition of Binkley compatible 5D point addressing.
  3033.     4.  Addition of Smart Zone and Point remapping
  3034.     5.  Addition of AutoEcho/AreaFix capabilities.
  3035.     6.  Addition of mailpacker/router (currently being written).
  3036.     7.  Full NETmail capability, but this is waiting for some major changes in
  3037.         RBBS-PC.
  3038.  
  3039.     If you have any comments, suggestions for enhancements or you  have  found
  3040.     something in RBBSMail that doesn't work the way it should,  feel  free  to
  3041.     contact me via Bamestra RBBS.  See the title page of this document for the
  3042.     node number and phonenumbers.  You may also leave a message in the RBBS-PC
  3043.     or RBBSMAIL_PACK Echomail conferences.
  3044.  
  3045.  
  3046.     10.2  Comments & Suggestions
  3047.  
  3048.  
  3049.     If you have comments on the workings  of  RBBSMail,  suggestions  for  new
  3050.     features, improvements or bug reports, feel free to send a NETmail message
  3051.     to Sysop at FIDO 2:512/10.0 (RBBSNet 8:998/1.0) or a written letter to the
  3052.     postal address listed on the title page.
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.     Future enhancements                                                     48
  3079.  
  3080.  
  3081.  
  3082.                                  RBBSMail v18.2
  3083.  
  3084.  
  3085.     Appendix A. Changes to RBBS-PC
  3086.  
  3087.  
  3088.     There is a conflict between RBBSMail's way of flagging messages  that  are
  3089.     processed and  "repair  message  file"  option  185  in  RBBS-PC's  CONFIG
  3090.     program.  RBBSMail changes the ":" (colon) in the datefield of the message
  3091.     header to a "." (dot) to flag a message.  CONFIG's option 185  will  choke
  3092.     on this, because it uses that same ":" to scan for valid message headers.
  3093.     This will result  in  mixed-up  message  numbering.   To  circumvent  this
  3094.     conflict, either do not use CONFIG option 185.  You  don't  normally  need
  3095.     that option, since RBBSMNT does a nice and FAST job  of  mesage/user  file
  3096.     maintenance and repair.  Alternatively you may remove the  following  line
  3097.     from linenumber 50580 of module CONFIG.BAS:
  3098.  
  3099.        AND MID$(MESSAGE.RECORD$,64,1) = ":" _
  3100.  
  3101.     This line appears TWICE in linenumber 50580.
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.     Appendix A. Changes to RBBS-PC                                          49
  3142.  
  3143.  
  3144.  
  3145.                                  RBBSMail v18.2
  3146.  
  3147.  
  3148.     Appendix B. Update history
  3149.  
  3150.  
  3151.     January 17, 1992 - Initial release of RBBSMail v18.0
  3152.  
  3153.     ■   Complete rewrite of RBBSMail in C.
  3154.     ■   Maintenance moved to a separate program RBBSMNT.
  3155.     ■   Buggy Zone and Point remapper removed.
  3156.  
  3157.     February 28, 1992 - release of RBBSMail v18.1
  3158.  
  3159.     ■   Added ExportComments configuration phrase.
  3160.     ■   Improved errorchecking for grunged bunldes.
  3161.     ■   Changed order in which ARCmail bundles are processed.
  3162.     ■   Fixed bug that incorrectly reported  inconsistent  header  records  in
  3163.         messages files.
  3164.     ■   Fixed bug that dumped copies of PASSTHRU messages in netmail area.
  3165.     ■   Fixed bug that incorrectly set message attributes on RTS messages.
  3166.     ■   Fixed bug in ARCmail address parsing (ARCto, ZIPto et al).
  3167.  
  3168.     September 17, 1992 - release of RBBSMail v18.2
  3169.  
  3170.     ■   Major rewrite to accomodate full 4-dimensional addressing.
  3171.     ■   Removed the DOMAIN configuration phrase, the ADDRESS config phrase  is
  3172.         now 5-dimensional.
  3173.     ■   Points can now be address with either their 4D or their 2D addresses.
  3174.     ■   Major rewrite so outbound mailbundles are FSC-0039 compliant.
  3175.     ■   Major  rewrite  to  recognize  FTS-0001r015,   FSC-0039/FSC-0048   and
  3176.         FSC-0045 compliant mailbundles.
  3177.     ■   Added Disk/EMS swap when running external programs.
  3178.     ■   Added NoSwap config phrase.  Disk/EMS swapping can now be disabled  in
  3179.         case of problems, lack of EMS memory of lack of disk space.
  3180.     ■   A change, required by the swapping routines,  was  made  to  the  PACK
  3181.         configuration phrase.
  3182.     ■   Added embedded commands in AREAS.BBS.
  3183.     ■   The ExportComments configuration phrase is replaced  by  the  embedded
  3184.         command  -ExportComments,   which   is   configurable   per   separate
  3185.         conference.
  3186.     ■   Added  mailbundle  password  protection  via  the  -Password  embedded
  3187.         command.
  3188.     ■   Added separate OVERFLOW subdir.
  3189.     ■   Added DynaPurge<tm>.
  3190.     ■   Added capability to copy incoming nemtail messages to a RBBS-PC  style
  3191.         conference.
  3192.     ■   Added NETBIOS file/record locking.
  3193.     ■   Added  RBBS-PC  compatible  file  locking  via  the  DESQview  mailbox
  3194.         interface.
  3195.     ■   Added NetBrick<tm> thrower.
  3196.     ■   Added Force2D config phrase.
  3197.     ■   Added FSC-0045 config phrase.
  3198.     ■   Added support for BinkleyTerm 4D POINT subdirectories.
  3199.     ■   Added StdARCmail config phrase.
  3200.     ■   Added YabomFA config phrase.
  3201.  
  3202.  
  3203.  
  3204.     Appendix B. Update history                                              50
  3205.  
  3206.  
  3207.  
  3208.                                  RBBSMail v18.2
  3209.  
  3210.  
  3211.     ■   Added support for RBBS-PC style messages with multiple CC: headers.
  3212.     ■   Large messages can now be split over multiple messages  in  a  RBBS-PC
  3213.         style message base.  Maximum lines per  message  is  configurable  per
  3214.         separate conference.
  3215.     ■   Message Margin is now configurable per separate conference.
  3216.     ■   Improved archive type recognition for ARCmail handling.
  3217.     ■   KillSent bit now properly set on forwarded netmail.
  3218.     ■   Plugged a hole in SecureMail.  Thanks, Kim kodde!
  3219.     ■   Fixed DESQView file locking.
  3220.     ■   Fixed problem that would sometimes drop addresses from SEEN-BY  and/or
  3221.         PATH lines.
  3222.     ■   Fixed problem with parsing ARCto et all parameters.
  3223.     ■   Fixed bug that sometimes made PASSTHRU areas inoperable.
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.     Appendix B. Update history                                              51
  3268.  
  3269.  
  3270.  
  3271.                                  RBBSMail v18.2
  3272.  
  3273.  
  3274.     Table of Contents
  3275.  
  3276.     1. WARNING!  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  3277.  
  3278.     2. What is RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  3279.  
  3280.       2.1  Software Requirements . . . . . . . . . . . . . . . . . . . . . . 2
  3281.       2.2  Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . 3
  3282.       2.3  Limitations.  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  3283.       2.4  Related Documents . . . . . . . . . . . . . . . . . . . . . . . . 4
  3284.       2.5  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . 4
  3285.  
  3286.     3. Legal Stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  3287.  
  3288.       3.1  Copyrights & License  . . . . . . . . . . . . . . . . . . . . . . 5
  3289.       3.2  NO WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  3290.       3.3  NO MONEY  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  3291.       3.4  The RBBS commitment . . . . . . . . . . . . . . . . . . . . . . . 8
  3292.  
  3293.     4. Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  3294.  
  3295.       4.1  Configuring RBBSMail  . . . . . . . . . . . . . . . . . . . . . . 9
  3296.       4.2  Valid phrases for RBBSMAIL.CFG  . . . . . . . . . . . . . . . . . 9
  3297.         4.2.1  Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  3298.         4.2.2  ARCto, ARJto, PAKto, LHAto, ZIPto, ZOOto.   . . . . . . . .  10
  3299.         4.2.3  StdARCmail  . . . . . . . . . . . . . . . . . . . . . . . .  11
  3300.         4.2.4  Domain  . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  3301.         4.2.5  Elastic . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  3302.         4.2.6  DupSize . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  3303.         4.2.7  DynaPurge . . . . . . . . . . . . . . . . . . . . . . . . .  12
  3304.         4.2.8  ExportComments  . . . . . . . . . . . . . . . . . . . . . .  12
  3305.         4.2.9  Gate  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  3306.         4.2.10  Hold . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  3307.         4.2.11  IBMFLAGS . . . . . . . . . . . . . . . . . . . . . . . . .  13
  3308.         4.2.12  ImportDate . . . . . . . . . . . . . . . . . . . . . . . .  13
  3309.         4.2.13  Indomain . . . . . . . . . . . . . . . . . . . . . . . . .  13
  3310.         4.2.14  KeepDups . . . . . . . . . . . . . . . . . . . . . . . . .  13
  3311.         4.2.15  KillNull . . . . . . . . . . . . . . . . . . . . . . . . .  14
  3312.         4.2.16  LogLevel . . . . . . . . . . . . . . . . . . . . . . . . .  14
  3313.         4.2.17  MaxOut . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  3314.         4.2.18  NetFile  . . . . . . . . . . . . . . . . . . . . . . . . .  14
  3315.         4.2.19  UseNETBIOS . . . . . . . . . . . . . . . . . . . . . . . .  15
  3316.         4.2.20  UseDV  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  3317.         4.2.21  NoRts  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  3318.         4.2.22  NetBrick . . . . . . . . . . . . . . . . . . . . . . . . .  15
  3319.         4.2.23  NoStinkingKludgeLines  . . . . . . . . . . . . . . . . . .  16
  3320.         4.2.24  OpusDate . . . . . . . . . . . . . . . . . . . . . . . . .  16
  3321.         4.2.25  Pack . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  3322.         4.2.26  PrivateNet . . . . . . . . . . . . . . . . . . . . . . . .  17
  3323.         4.2.27  Force2D  . . . . . . . . . . . . . . . . . . . . . . . . .  18
  3324.         4.2.28  FSC-0045 . . . . . . . . . . . . . . . . . . . . . . . . .  19
  3325.         4.2.29  Size . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  3326.         4.2.30  Security . . . . . . . . . . . . . . . . . . . . . . . . .  19
  3327.  
  3328.  
  3329.  
  3330.     Table of Contents                                                       52
  3331.  
  3332.  
  3333.  
  3334.                                  RBBSMail v18.2
  3335.  
  3336.  
  3337.         4.2.31  SecureMail . . . . . . . . . . . . . . . . . . . . . . . .  19
  3338.         4.2.32  StatusLog  . . . . . . . . . . . . . . . . . . . . . . . .  19
  3339.         4.2.33  StripSeen  . . . . . . . . . . . . . . . . . . . . . . . .  19
  3340.         4.2.34  SwapPath . . . . . . . . . . . . . . . . . . . . . . . . .  20
  3341.         4.2.35  NoSwap.  . . . . . . . . . . . . . . . . . . . . . . . . .  20
  3342.         4.2.36  SysAlias . . . . . . . . . . . . . . . . . . . . . . . . .  20
  3343.         4.2.37  Sysop  . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  3344.         4.2.38  YabomFA  . . . . . . . . . . . . . . . . . . . . . . . . .  20
  3345.         4.2.39  Reading BINKLEY.CFG  . . . . . . . . . . . . . . . . . . .  21
  3346.         4.2.40  Example of a RBBSMAIL.CFG file . . . . . . . . . . . . . .  22
  3347.         4.2.41  Example of an AREAS.BBS file . . . . . . . . . . . . . . .  23
  3348.       4.3  Special AREA: names . . . . . . . . . . . . . . . . . . . . . .  25
  3349.         4.3.1  The OVERFLOW area . . . . . . . . . . . . . . . . . . . . .  25
  3350.         4.3.2  The XNETMAIL area . . . . . . . . . . . . . . . . . . . . .  26
  3351.       4.4  Embedded commands in AREAS.BBS  . . . . . . . . . . . . . . . .  26
  3352.         4.4.1  -Margin . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  3353.         4.4.2  -MaxLines . . . . . . . . . . . . . . . . . . . . . . . . .  27
  3354.         4.4.3  -Notify . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  3355.         4.4.4  -NoNotify . . . . . . . . . . . . . . . . . . . . . . . . .  28
  3356.         4.4.5  -ExportComments . . . . . . . . . . . . . . . . . . . . . .  28
  3357.         4.4.6  -NoExportComments . . . . . . . . . . . . . . . . . . . . .  28
  3358.         4.4.7  -Security . . . . . . . . . . . . . . . . . . . . . . . . .  28
  3359.         4.4.8  -Slack & -MsgAge  . . . . . . . . . . . . . . . . . . . . .  29
  3360.         4.4.9  -OrgAddress . . . . . . . . . . . . . . . . . . . . . . . .  30
  3361.         4.4.10  -Password  . . . . . . . . . . . . . . . . . . . . . . . .  30
  3362.  
  3363.     5. Running RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . .  32
  3364.  
  3365.       5.1  Commandline options . . . . . . . . . . . . . . . . . . . . . .  32
  3366.         5.1.1  -A <areasbbsfile> . . . . . . . . . . . . . . . . . . . . .  32
  3367.         5.1.2  -AKA #  . . . . . . . . . . . . . . . . . . . . . . . . . .  32
  3368.         5.1.3  -BM . . . . . . . . . . . . . . . . . . . . . . . . . . . .  32
  3369.         5.1.4  -C <configfile> . . . . . . . . . . . . . . . . . . . . . .  33
  3370.         5.1.5  -FA . . . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  3371.         5.1.6  -H  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  3372.         5.1.7  -I  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  3373.         5.1.8  -KN . . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  3374.         5.1.9  -OB . . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  3375.         5.1.10  -OF  . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  3376.         5.1.11  -OP  . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  3377.         5.1.12  -P . . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  3378.         5.1.13  -S . . . . . . . . . . . . . . . . . . . . . . . . . . . .  35
  3379.         5.1.14  -T . . . . . . . . . . . . . . . . . . . . . . . . . . . .  35
  3380.         5.1.15  -X . . . . . . . . . . . . . . . . . . . . . . . . . . . .  35
  3381.  
  3382.     6. A word on echomail distribution . . . . . . . . . . . . . . . . . .  36
  3383.  
  3384.     7. A word on RBBS-PC MESSAGES files  . . . . . . . . . . . . . . . . .  38
  3385.  
  3386.       7.1  Filesizes . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  3387.       7.2  Filenames for CONFERENCES . . . . . . . . . . . . . . . . . . .  38
  3388.       7.3  Filenames for SUBBOARDS . . . . . . . . . . . . . . . . . . . .  39
  3389.       7.4  Filenames for FIDO style subdirs  . . . . . . . . . . . . . . .  40
  3390.  
  3391.  
  3392.  
  3393.     Table of Contents                                                       53
  3394.  
  3395.  
  3396.  
  3397.                                  RBBSMail v18.2
  3398.  
  3399.  
  3400.     8. How to set up your mail . . . . . . . . . . . . . . . . . . . . . .  41
  3401.  
  3402.       8.1  What you need . . . . . . . . . . . . . . . . . . . . . . . . .  41
  3403.       8.2  A quick overview  . . . . . . . . . . . . . . . . . . . . . . .  42
  3404.       8.3  Enhanced Setup / CRITMON<tm>  . . . . . . . . . . . . . . . . .  42
  3405.       8.4  Cross-zone echomail / CRITMON<tm> . . . . . . . . . . . . . . .  43
  3406.       8.5  Network Gateway Systems . . . . . . . . . . . . . . . . . . . .  44
  3407.       8.6  Error determination . . . . . . . . . . . . . . . . . . . . . .  45
  3408.       8.7  Other stuff . . . . . . . . . . . . . . . . . . . . . . . . . .  46
  3409.  
  3410.     9. The RBBSNet . . . . . . . . . . . . . . . . . . . . . . . . . . . .  47
  3411.  
  3412.     10. Future enhancements  . . . . . . . . . . . . . . . . . . . . . . .  48
  3413.  
  3414.       10.1  Planned for new releases . . . . . . . . . . . . . . . . . . .  48
  3415.       10.2  Comments & Suggestions . . . . . . . . . . . . . . . . . . . .  48
  3416.  
  3417.     Appendix A. Changes to RBBS-PC . . . . . . . . . . . . . . . . . . . .  49
  3418.  
  3419.     Appendix B. Update history . . . . . . . . . . . . . . . . . . . . . .  50
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.     Table of Contents                                                       54
  3457.