home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / PTKTDOC3.ZIP / CONFMAIL.DOC < prev    next >
Text File  |  1988-08-23  |  71KB  |  2,047 lines
  1.  
  2.  
  3.  
  4.                                         
  5.                                         
  6.                                         
  7.                                         
  8.                                         
  9.                                         
  10.                                         
  11.                                         
  12.                                         
  13.                                         
  14.                                         
  15.                            The Conference Mail System
  16.                                         
  17.                                        By
  18.                                   Bob Hartman
  19.                        Sysop of FidoNet(tm) node 132/101
  20.                                         
  21.                  (C) Copyright 1986,87,88 Spark Software, Inc.
  22.                                         
  23.                               427-3 Amherst Street
  24.                               CS  2032, Suite  232
  25.                               Nashua,  N.H.  03061
  26.                                         
  27.                               ALL RIGHTS RESERVED.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.       Conference Mail System Revision 4.00                 August 23, 1988
  69.  
  70.      WHAT IS THE CONFERENCE MAIL SYSTEM?
  71.  
  72.           Conference Mail  is a  technique to  permit several  nodes  on  a
  73.           network to  share a  message base,  similar  in  concept  to  the
  74.           conferences available on many of the computer services, but it is
  75.           most closely related to the Usenet system consisting of more than
  76.           8,000 systems  world wide. All systems sharing a given conference
  77.           see any  messages entered  into the  conference  by  any  of  the
  78.           participating systems.  This can  be implemented in such a way as
  79.           to be  totally transparent  to the users of a particular node. In
  80.           fact, they  may not  even be  aware of  the network being used to
  81.           move their  messages about from node to node! Unfortunately, this
  82.           has its  disadvantages also  - most  users who  are not  educated
  83.           about Conference  Mail do  not realize  the messages  transmitted
  84.           cost MANY  sysops (system  operators) money,  not just  the local
  85.           sysop. This  is an important consideration in Conference Mail and
  86.           should not be taken lightly.  In a conference with 100 systems as
  87.           participants the cost per message can get quite high.
  88.  
  89.           The Conference  Mail System is designed to operate in conjunction
  90.           with a  FidoNet compatible  mail server.  The currently supported
  91.           mail servers  are Fido(tm),  SEAdog(tm), Opus, and Dutchie. Since
  92.           the mail  server is  a prerequisite  to using the Conference Mail
  93.           System, it  will be  assumed you  already have  your mail  server
  94.           operating correctly  on your   system, and you are connected into
  95.           FidoNet or a compatible network.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                      Page 2
  132.  
  133.  
  134.       Conference Mail System Revision 4.00                 August 23, 1988
  135.  
  136.      HISTORY OF THE CONFERENCE MAIL SYSTEM
  137.  
  138.           In late  1985, Jeff  Rush, a  Fido  sysop  in  Dallas,  wanted  a
  139.           convenient means  of sharing  ideas with the other Dallas sysops.
  140.           He created  a system  of programs  he called  Echomail,  and  the
  141.           Dallas sysops' Conference was born.
  142.  
  143.           Within a  short time  sysops in other areas began hearing of this
  144.           marvelous new  gadget and  Echomail took  on a  life of  its own.
  145.           Today, a  scant year and a half later, the FidoNet public network
  146.           boasts a myriad of conferences varying in size from the dozen-or-
  147.           so participants  in the  FidoNet  Technical  Standards  Committee
  148.           Conference  to   the  Sysops'  Conference  with  several  hundred
  149.           participants. It  is not  uncommon for a node to carry 30 or more
  150.           conferences and share those conferences with 10 or more nodes.
  151.  
  152.           Unfortunately, this  incredible growth  pointed out limits in the
  153.           original Echomail  programs. In  particular, the  processing  was
  154.           slow, a  few 'bugs'  surfaced, and  more features  were needed to
  155.           make a sysop's life just a bit easier.
  156.  
  157.           In November  of 1986 I (Bob Hartman) began work on the Conference
  158.           Mail System,  a faster,  more  powerful  system  compatible  with
  159.           Echomail. This  system started out as a series of programs called
  160.           FastToss, FastKDup  and FastScan.  The system  was relatively bug
  161.           free, and  provided significantly greater speed than the original
  162.           Echomail utilities.  It also  added functions  designed  to  make
  163.           Echomail more attractive to the average sysop.
  164.  
  165.           The current  version of Conference Mail has more features, and is
  166.           faster than  what was  known as  the FastEcho series of programs.
  167.           This newest  program is  what you  have received  with along this
  168.           documentation..
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                      Page 3
  198.  
  199.  
  200.       Conference Mail System Revision 4.00                 August 23, 1988
  201.  
  202.      HOW IT WORKS
  203.  
  204.           The Conference  Mail System  is functionally  compatible with the
  205.           original Echomail utilities.  In general, the process is:
  206.  
  207.           1. A  message is  entered into  a designated  area on  a  FidoNet
  208.           compatible system.
  209.  
  210.           2. This message is "Exported" along with some control information
  211.           to each system "linked" to the conference through the originating
  212.           system.
  213.  
  214.           3. Each  of the  receiving systems  "Import" the message into the
  215.           proper Conference Mail area.
  216.  
  217.           4. The receiving systems then "Export" these messages, along with
  218.           additional control  information,  to  each  of  their  conference
  219.           links.
  220.  
  221.           5. Return to step 3.
  222.  
  223.           As you  can see,  the method  is quite  simple -  in general.  Of
  224.           course, following  the steps  literally would mean messages would
  225.           never stop being Exported and transmitted to other systems.  This
  226.           obviously would  not be  desired or  the  network  would  quickly
  227.           become overburdened.  The information  contained in  the 'control
  228.           information' section  is used  to prevent  transmitting the  same
  229.           message more than once to a single system.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                      Page 4
  264.  
  265.  
  266.       Conference Mail System Revision 4.00                 August 23, 1988
  267.  
  268.      CONFERENCE MAIL MESSAGE CONTROL INFORMATION
  269.  
  270.           There are  five pieces  of control  information associated with a
  271.           Conference  Mail  message.  Some  are  optional,  some  are  not.
  272.           Normally this information is never entered by the person creating
  273.           the  message.   The  following   control  fields   determine  how
  274.           Conference Mail is handled:
  275.  
  276.           1. Area line
  277.  
  278.                This is  the first  line of  a conference  mail message. Its
  279.                actual appearance is:
  280.  
  281.                                      AREA:CONFERENCE
  282.  
  283.                Where CONFERENCE is the name of the conference. This line is
  284.                added when  a conference  is  being  "Exported"  to  another
  285.                system. It  is based upon information found in the AREAS.BBS
  286.                (configuration) File  for the  designated message area. This
  287.                field is  REQUIRED by  the receiving  system to  "Import"  a
  288.                message into the correct Conference Mail area.
  289.  
  290.           2. Tear Line
  291.  
  292.                This line is near the end of a message and consists of three
  293.                dashes (---)  followed by  an  optional  program  specifier.
  294.                This is  used to show the first program used to add Echomail
  295.                compatible control information to the message. The tear line
  296.                generated by Conference Mail looks like:
  297.  
  298.                                     --- ConfMail v4.00
  299.  
  300.                This  field   is  optional   for  most  Echomail  compatible
  301.                processors, and  is added  by the  Conference Mail System to
  302.                ensure complete  compatibility. Some systems will place this
  303.                line in  the message  when it  is first  created, but  it is
  304.                normally added when the message is first "exported."
  305.  
  306.           3. Origin line
  307.  
  308.                This line  appears near  the bottom of a message and gives a
  309.                small amount  of  information  about  the  system  where  it
  310.                originated. It looks like:
  311.  
  312.                       * Origin: The Conference Mail BBS (1:132/101)
  313.  
  314.                The "  * Origin:  " part  of the  line is  a constant field.
  315.                This is followed by the name of the system as taken from the
  316.                AREAS.BBS file  or a  file named  ORIGIN located  in the DOS
  317.                directory of  the  designated  message  area.  The  complete
  318.                network address  (1:132/101 in  this case)  is added  by the
  319.                program inserting  the line.  This field is generated at the
  320.                same time  as the  tear line,  and therefore  may either  be
  321.                generated at  the time  of  creation  or  during  the  first
  322.                "export"  processing.   Although  the  Origin  line  is  not
  323.                required by  all Echomail  processors, it  is added  by  the
  324.                Conference Mail System to ensure complete compatibility.
  325.  
  326.  
  327.  
  328.  
  329.                                      Page 5
  330.  
  331.  
  332.       Conference Mail System Revision 4.00                 August 23, 1988
  333.  
  334.           4. Seen-by Lines
  335.  
  336.                There can  be many  seen-by lines  at the  end of Conference
  337.                Mail messages,  and they  are the real "meat" of the control
  338.                information. They  are used  to  determine  the  systems  to
  339.                receive the exported messages. The format of the line is:
  340.  
  341.                            SEEN-BY: 132/101 113 136/601 1014/1
  342.  
  343.                The net/node  numbers correspond  to the net/node numbers of
  344.                the systems having already received the message. In this way
  345.                a message  is never  sent to a system twice. In a conference
  346.                with many  participants the  number of  seen-by lines can be
  347.                very large.   This line is added if it is not already a part
  348.                of the  message, or added to if it already exists, each time
  349.                a message  is exported  to other systems. This is a REQUIRED
  350.                field, and  Conference Mail  will not  function correctly if
  351.                this field  is not put in place by other Echomail compatible
  352.                programs.
  353.  
  354.           5. PATH Lines
  355.  
  356.                These are  the last  lines in  a Conference Mail message and
  357.                are a  new addition,  and therefore  is not supported by all
  358.                Echomail processors. It appears as follows:
  359.  
  360.                                   ^aPATH: 132/101 1014/1
  361.  
  362.                Where the  ^a stands  for Control-A  (ASCII character 1) and
  363.                the net/nodes  listed correspond  to  those  systems  having
  364.                processed the  message before it reached the current system.
  365.                This is  not the  same as  the seen-by  lines, because those
  366.                lines list  all systems  the message has been sent to, while
  367.                the path line contains all systems having actually processed
  368.                the message.  This is not a required field, and few echomail
  369.                processors currently  support it,  however it  can  be  used
  370.                safely with  any other  system, since  the line(s)  will  be
  371.                ignored. For  a discussion  on how  the  path  line  can  be
  372.                helpful, see the "Advanced Features" section of this manual.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                      Page 6
  396.  
  397.  
  398.       Conference Mail System Revision 4.00                 August 23, 1988
  399.  
  400.      SETTING UP THE CONFERENCE MAIL SYSTEM
  401.  
  402.           To set up the Conference Mail System, the following steps must be
  403.           followed:
  404.  
  405.           1. Have  a working  FidoNet compatible  system using  the message
  406.           format described  by the  FidoNet Technical  Standards  Committee
  407.           (FTSC) in  the document FSC001. This basically means TBBS systems
  408.           cannot use  the Conference  Mail System  since they do not have a
  409.           message base  of the  appropriate format.  Systems known  to work
  410.           with the  Conference Mail  System are  listed  in  the  "What  is
  411.           Conference Mail?" section of this manual.
  412.  
  413.           2. Determine  the conferences  you would  like to  start, and the
  414.           conferences you  would like  to receive. A good place to start is
  415.           by looking  for a  file called ECHOLST.ARC on your local bulletin
  416.           board already  running an  Echomail compatible system.  This list
  417.           contains information on tying into over 100 known conferences are
  418.           already popular throughout FidoNet.
  419.  
  420.           3. Set  up a  directory for  messages for  each of  the  separate
  421.           conferences. Yes,  you read  correctly -  one directory  for each
  422.           conference. If you do not create individual directories, then you
  423.           will run  into a  problem known  as "cross-linking" a conference.
  424.           This means  the information  from  one  conference  will  end  up
  425.           intermingled with  another. Although this is sometimes desirable,
  426.           generally it  causes severe  backlash at  the person responsible.
  427.           For example,  imagine if  the two areas accidentally cross-linked
  428.           were the BLACK_MAGIC and BIBLE areas. Needless to say there would
  429.           be an  uproar  in  the  conference  getting  material  originally
  430.           destined for  the other  conference. Unfortunately,  this happens
  431.           all too  often, and  even the  most experienced  Conference  Mail
  432.           wizards will  make this  mistake. Refer  to the documentation for
  433.           your FidoNet  compatible system  for how  to make  this directory
  434.           accessible to the system.
  435.  
  436.           4. Set  up the  AREAS.BBS configuration  file for your system and
  437.           the conferences  you wish  to receive  (see the  section entitled
  438.           "Configuration (AREAS.BBS)  file).  This  file  must  be  in  the
  439.           correct format,  and should be thoroughly tested on a small scale
  440.           before linking to any large conferences.
  441.  
  442.           5. Alter  your batch  files to  make the appropriate calls to the
  443.           Conference Mail  system for  importing, exporting and maintaining
  444.           the message  bases. Samples  batch file sections are given in the
  445.           section entitled "Batch File Examples".
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                      Page 7
  462.  
  463.  
  464.       Conference Mail System Revision 4.00                 August 23, 1988
  465.  
  466.           6. Set up conference links with other systems for the conferences
  467.           you are  interested in. To do this, simply send a netmail message
  468.           to the  other system  requesting to  tie into  the conference  in
  469.           question. If  the sysop  does not  carry the  conference they can
  470.           usually point  you in  the right direction. Remember when setting
  471.           up links,  local calls  are preferred  since Conference  Mail can
  472.           generate large  phone bills if taken to extremes. Also be careful
  473.           of conference  "topology" (see  the section  entitled "Conference
  474.           Topology" for  more details). Also determine with the other sysop
  475.           if "ARCmail"  is to  be used  or not (ARCmail is discussed in the
  476.           section entitled "Methods of Sending Conference Mail").
  477.  
  478.           If all  of these  procedures are followed, then the result should
  479.           be a fully operational Conference Mail System.
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.                                      Page 8
  528.  
  529.  
  530.       Conference Mail System Revision 4.00                 August 23, 1988
  531.  
  532.      CONFIGURATION (AREAS.BBS) FILE
  533.  
  534.           The Configuration  File for the Conference Mail System is usually
  535.           called AREAS.BBS.  It may  be called  any name,  but AREAS.BBS is
  536.           used for historical reasons. The file has 4 parts:
  537.  
  538.           1. Comment  lines -  these lines may appear anywhere in the file.
  539.           They  are   blank  lines,   or  start   with  a  semi-colon  (;).
  540.           Historically there  is one  other special  type of  comment  line
  541.           starting with a dash (-). The Conference Mail System uses some of
  542.           the dash lines as "special command" lines (see number 3 below).
  543.  
  544.           2. Board  name !  Sysop name - this line is the first line of the
  545.           file  other  than  comment  lines.  This  line  is  used  by  the
  546.           Conference Mail  System when  it generates  an Origin  line  (see
  547.           section entitled  "How it  Works"),  and  also  the  name  to  be
  548.           substituted for  Sysop when  it is  found in  the FROM field of a
  549.           message. The  format of  the line  is free  format with the board
  550.           name and  sysop name  separated by  an exclamation point (!). The
  551.           zone:net/node will  be appended to this information, so it should
  552.           never appear in the file itself. For example:
  553.  
  554.                The Conference Mail BBS ! Bob Hartman
  555.  
  556.           might expand to:
  557.  
  558.                 * Origin: The Conference Mail BBS (1:132/101.1)
  559.  
  560.           3. Special  Commands -  these lines begin with a dash (-) and are
  561.           followed by  a special keyword. The supported keywords (discussed
  562.           in the "Advanced Features" section) are:
  563.  
  564.           All versions:
  565.                ZONEGATE
  566.                PASSWORD
  567.  
  568.           "Point" versions:
  569.                POINTNET
  570.                BOSSNODE
  571.  
  572.           4. Conference  lines -  All other  lines in the file fit into the
  573.           category of  Conference lines.  These lines  have a  very special
  574.           format as follows:
  575.  
  576.                Directory    Area   Nodes
  577.  
  578.           Each line  has the  same format,  although each  line may use the
  579.           following format pieces differently:
  580.  
  581.           Directory  -  this  may  be  either  a  path  name  (easiest  and
  582.           recommended method) or it may be a Fido/Opus area number.
  583.  
  584.           Area -  This is  the label  associated with the Conference. It is
  585.           important to  have this  spelled correctly (upper/lower case does
  586.           not matter)  since incorrectly  spelled area  names will  not  be
  587.           recognized.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                                      Page 9
  594.  
  595.  
  596.       Conference Mail System Revision 4.00                 August 23, 1988
  597.  
  598.           Nodes - These are the nodes sharing the conference. The format is
  599.           a list  of net/node  numbers for each node.  If the net number is
  600.           the same for two consecutive nodes, then the net number and slash
  601.           (/) may  be deleted  for the  second number. For example, both of
  602.           the following  are equivalent (the first node number must have an
  603.           associated net number):
  604.  
  605.                132/101 132/107 132/555 136/601
  606.                132/101 107 555 136/601
  607.  
  608.           The entire  list of  nodes is  optional for  a conference - it is
  609.           often desirable to have an area called GENERAL and another called
  610.           PRIVATE with  no links  listed in order to get general or private
  611.           mail from  other boards  running  compatible  software  (this  is
  612.           considered standard  practice, although  as some  users have said
  613.           "You may  go a  lifetime and never see anyone use this feature on
  614.           your system,  but the  capability is there"). On a system running
  615.           "secure"  Conference   Mail  (see   section  entitled   "Advanced
  616.           Features"), this is not recommended.
  617.  
  618.      Sample Configuration (AREAS.BBS) File:
  619.  
  620.           ; The first line that is not a comment line is the
  621.           ; Board Name ! Sysop Name line.  This MUST appear or
  622.           ; the Conference Mail System will not function correctly
  623.           
  624.           The Conference Mail BBS ! Bob Hartman
  625.           
  626.           ; The next section of lines is my "special command"
  627.           ; section.  It gives examples of the use of three
  628.           ; "special" commands.  This is actually the
  629.           ; setup for a possible "point server" node.  For a
  630.           ; "point" itself, the POINTNET line would be changed
  631.           ; to a BOSSNODE line as in "-BOSSNODE=132/101".  Note
  632.           ; the dash (-) is in column 1 (this is important)
  633.           ; and there are no spaces until after the number
  634.           ; following the equal sign (=).
  635.           
  636.           -POINTNET=1014
  637.           -ZONEGATE=3/1 1/3 105/30
  638.           -PASSWORD=1014/1 ConfMail
  639.           
  640.           ; Now come all of the Conference Lines:
  641.           
  642.           ;  Directory   Area    Node 1  Node 2  Node 3  Node 4
  643.           
  644.           C:\MSG\PRIVATE PRIVATE
  645.           C:\MSG\GENERAL GENERAL
  646.           C:\MSG\SYSOP   SYSOP   132/101 136/601 107/312 1014/1
  647.           C:\MSG\TECH    TECH    132/101 136/601 107/312 1014/1
  648.           C:\MSG\POINT   POINT                           1014/1
  649.           C:\MSG\NESYSOP NESYSOP 132/101                 1014/1
  650.           
  651.           ; The above lines are in columns simply to be pleasing
  652.           ; to the eye.  It is not necessary, but it does make
  653.           ; changing the lists much easier. The column headings
  654.           ; are also given for clarity and are not required.
  655.  
  656.  
  657.  
  658.  
  659.                                     Page 10
  660.  
  661.  
  662.       Conference Mail System Revision 4.00                 August 23, 1988
  663.  
  664.      METHODS OF SENDING CONFERENCE MAIL
  665.  
  666.           To this  point the  issue of how Conference Mail is actually sent
  667.           has been glossed over entirely. The phrase has been, "the message
  668.           is exported  to another  system."   What exactly  does this mean?
  669.           Well, for starters lets show what is called the "basic" setup:
  670.  
  671.           In this setup exported mail is placed into the FidoNet mail area.
  672.           Each message   exported  from a  Conference  Mail  area  has  one
  673.           message generated  for each  receiving system.  This mail is then
  674.           sent the  same as any other network mail. When Echomail was first
  675.           created this was the only way mail could be sent.
  676.  
  677.           The "basic"  method has some disadvantages. First, since Echomail
  678.           has grown so large it is not uncommon to get 200 new messages per
  679.           day imported  into various message bases. It is also not uncommon
  680.           for a  system to  be exporting  messages to 4 or 5 other systems.
  681.           Simple arithmetic  shows 800-1000  messages per day would be sent
  682.           in normal  netmail! This  puts a tremendous strain on any netmail
  683.           system, not  to mention transmission time and the resultant phone
  684.           charges. When this limitation of Echomail was first noticed a lot
  685.           of people started scratching their heads wondering what to do. If
  686.           a  solution  could  not  be  found  it  appeared  Echomail  would
  687.           certainly overrun the capabilities of FidoNet.
  688.  
  689.           Thom Henderson  (from System Enhancement Associates) came up with
  690.           the original  ARCmail program.  Having previously written the ARC
  691.           file archiving  and compression  program,  he  knew  the  savings
  692.           achievable by  having all  of the netmail messages placed in .ARC
  693.           format for  transmission. As  a byproduct, the messages no longer
  694.           appeared in  the netmail  area,  but  were  included  in  a  file
  695.           attached to  a message  (see your  FidoNet mailer manual for file
  696.           attaches).  In   this  way  the  tremendous  number  of  messages
  697.           generated, and the phone bill problems were both solved.
  698.  
  699.           Unfortunately, ARCmail  required the  messages to first be placed
  700.           into the  netmail area  before it  could be  run. In  effect,  it
  701.           caused the  messages to  be scanned once when they were exported,
  702.           once during  the ARCmail  phase, once when ARCmail was run at the
  703.           other end  to get  the messages out of .ARC format, and once when
  704.           those messages  were later  imported into  a message  base on the
  705.           receiving system.  The Conference Mail System solves this problem
  706.           by eliminating  the ARCmail  program. Conference  Mail builds the
  707.           ARCmail files during Export, and unpacks them during Import. This
  708.           way  messages   are  exported  directly  to  ARCmail  style  file
  709.           attaches, and imported directly from ARCmail style file attaches.
  710.           The scanning  phases between importing and exporting messages are
  711.           totally removed and processing time is proportionally reduced.
  712.  
  713.           This is  now the  most common  method for sending Conference Mail
  714.           between systems.  The overhead  involved in  doing it  during the
  715.           importing and exporting phases is much less than what is involved
  716.           if ARCmailing  is not  utilized. This was a primary consideration
  717.           in the  design and  implementation of the Conference Mail System,
  718.           and as  a result  the entire system is optimized for this type of
  719.           use.  Please  refer  to  the  Import  and  Export  functions  for
  720.           specifics on how to use the ARCmailing feature.
  721.  
  722.  
  723.  
  724.  
  725.                                     Page 11
  726.  
  727.  
  728.       Conference Mail System Revision 4.00                 August 23, 1988
  729.  
  730.      CONFERENCE TOPOLOGY
  731.  
  732.           The  way   in  which  systems  link  together  for  a  particular
  733.           conference is  called the "conference topology."  It is important
  734.           to know  this structure  for two  reasons: 1)  It is important to
  735.           have a  topology which  is  efficient  in  the  transfer  of  the
  736.           Conference Mail  messages, and  2) It  is  important  to  have  a
  737.           topology which  will not  cause systems  to see the same messages
  738.           more than once.
  739.  
  740.           Efficiency can  be measured  in a  number  of  ways;  least  time
  741.           involved for all systems to receive a message, least cost for all
  742.           systems to receive a message, and fewest phone calls required for
  743.           all systems  to receive  a message  are all  valid indicators  of
  744.           efficiency. Users  of Echomail compatible systems have determined
  745.           (through trial  and error)  the best  measure of  efficiency is a
  746.           combination  of  all  three  of  the  measurements  given  above.
  747.           Balancing the equation is not trivial, but some guidelines can be
  748.           given:
  749.  
  750.                1. Never have two systems attempting to send Conference mail
  751.                to each other at the same time. This results in "collisions"
  752.                that will  cause both  systems to  fail. To  avoid this, one
  753.                system should  be responsible  for polling  while the  other
  754.                system is holding mail. This arrangement can alternate based
  755.                upon various  criteria, but  both systems  should  never  be
  756.                attempting to call each other at the same time.
  757.  
  758.                2. Have  nodes form  "stars" for  distribution of Conference
  759.                Mail. This arrangement has several nodes all receiving their
  760.                Conference Mail from the same system. In general the systems
  761.                on the  "outside"  of  the  star  poll  the  system  on  the
  762.                "inside". The  system on  the "inside"  in turn  polls other
  763.                systems to  receive the Conference Mail that is being passed
  764.                on to the "outside" systems.
  765.  
  766.                3. Utilize  fully connected  polygons with  a few  vertices.
  767.                Nodes can  be connected in a triangle (A sends to B and C, B
  768.                sends to  A and  C, C sends to A and B) or a fully connected
  769.                square (all  corners of  the square send to all of the other
  770.                corners). This  method is useful for getting Conference Mail
  771.                messages to each node as quickly as possible.
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.                                     Page 12
  792.  
  793.  
  794.       Conference Mail System Revision 4.00                 August 23, 1988
  795.  
  796.           All of  these efficiency  guidelines have to be tempered with the
  797.           guidelines dealing  with keeping  duplicate messages  from  being
  798.           exported. Duplicates  will occur  in any  topology that  forms  a
  799.           closed polygon  that is not fully connected. Take for example the
  800.           following configuration:
  801.  
  802.                                       A ----- B
  803.                                       |       |
  804.                                       |       |
  805.                                       C ----- D
  806.  
  807.           This square  is a  closed polygon that is not fully connected. It
  808.           is capable of generating duplicates as follows:
  809.  
  810.                1. A message is entered on node A.
  811.  
  812.                2. Node  A exports  the message to node B and node C placing
  813.                the seen-by for A, B, and C in the message as it does so.
  814.  
  815.                3. Node  B sees that node D is not listed in the seen-by and
  816.                exports the message to node D.
  817.  
  818.                4. Node  C sees that node D is not listed in the seen-by and
  819.                exports the message to node D.
  820.  
  821.           At this  point node  D has  received the  same message  twice - a
  822.           duplicate was  generated. Normally  a "dup-ring"  will not  be as
  823.           simple as  a square.  Generally it  will be caused by a system on
  824.           one end  of a  long chain  accidentally connecting to a system on
  825.           the other end of the chain. This causes the two ends of the chain
  826.           to become connected, forming a polygon.
  827.  
  828.           In FidoNet  this problem  is reduced somewhat by having "Regional
  829.           Echomail Coordinators"  (RECS) that try to keep track of Echomail
  830.           connections within  their regions  of the  world. A  further rule
  831.           which is  followed is  that only  the RECS  are allowed  to  make
  832.           inter-regional connections for the larger conferences. In return,
  833.           the RECS  have established  a very  efficient topology which gets
  834.           messages from  coast to  coast, and onto over 200 systems in less
  835.           than 24  hours. If  no one were willing to follow the rules, then
  836.           this system  would collapse,  but due to the excellent efficiency
  837.           it has remained intact for over a year.
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                                     Page 13
  858.  
  859.  
  860.       Conference Mail System Revision 4.00                 August 23, 1988
  861.  
  862.      ADVANCED FEATURES
  863.  
  864.      Special AREAS.BBS Commands (all versions of Conference Mail)
  865.  
  866.           PASSWORD
  867.  
  868.                The format for this line is:
  869.  
  870.                     -PASSWORD=net/node password
  871.  
  872.                where 'net/node'  is the net/node number of the system using
  873.                this password,  and 'password'  is up  to 8  characters of a
  874.                password. This  option is  currently only  supported by  the
  875.                Conference Mail System. The method used for this feature has
  876.                been approved  by the  FidoNet Technical Standards Committee
  877.                (FTSC),  and   should  start  appearing  in  other  Echomail
  878.                processors in  the future.  Up to  100 systems  can be given
  879.                passwords by having a separate -PASSWORD= line for each one.
  880.  
  881.                If Conference  Mail is  received in  ARCmail format  from  a
  882.                system listed  on a -PASSWORD= line, the ARCmail packet will
  883.                be checked  for the  proper password, and if the password is
  884.                missing, or  incorrect the  packet will  be  renamed  and  a
  885.                message generated  to alert the sysop. ARCmail created for a
  886.                node listed  on a -PASSWORD= line will be generated with the
  887.                password in  place, so the receiving system should also have
  888.                the same  password in place in their AREAS.BBS file. This is
  889.                part of  the security  discussed more  fully in  the section
  890.                entitled "Creating a Secure Environment."
  891.  
  892.           ZONEGATE
  893.  
  894.                The format for this line is:
  895.  
  896.                     -ZONEGATE=a/b c/d e/f ...
  897.  
  898.                where 'a/b' is the net/node number of the system that is the
  899.                "zonegate" and  'c/d e/f ...' are the net/node numbers to be
  900.                listed in  the seen-by  lines of  messages exported  to  the
  901.                "zonegate."  This   option  is   primarily  used   to   keep
  902.                transmission costs  down by  deleting seen-bys  for  systems
  903.                that are not in the same "zone". If a message goes through a
  904.                "zonegate" it  can never  return  except  through  the  same
  905.                "zonegate", hence  all seen-bys  for the  original zone  can
  906.                safely be  removed. This  option allows  this,  as  well  as
  907.                specifying a  extra  seen-bys  to  be  listed  in  case  the
  908.                PASSTHRU option is also being used (see the section entitled
  909.                "Using the Passthru Option").
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.                                     Page 14
  924.  
  925.  
  926.       Conference Mail System Revision 4.00                 August 23, 1988
  927.  
  928.      Special AREAS.BBS Commands ("Point" versions of Conference Mail)
  929.  
  930.           POINTNET
  931.  
  932.                This format for this line is:
  933.  
  934.                     -POINTNET=net
  935.  
  936.                Where 'net' corresponds to the net number of the private net
  937.                which is  used to  support "points." This option should ONLY
  938.                be used  on a  system supporting  points, and  never  on  an
  939.                actual point.  This option  strips  all  occurances  of  the
  940.                private net  number from  appearing in  the seen-by lines of
  941.                messages exported  to other systems. This is necessary since
  942.                many nodes  might have  the same  private network number for
  943.                the points that they service, and seen-by lines generated on
  944.                one system  might cause  points on  another  system  to  not
  945.                receive the messages.
  946.  
  947.           BOSSNODE
  948.  
  949.                The format for this line is:
  950.  
  951.                     -BOSSNODE=net/node
  952.  
  953.                where 'net/node'  is the net/node number of the system which
  954.                acts as a point server. This option should ONLY be used on a
  955.                system which  is a  point. It  causes  the  Origin  line  to
  956.                contain a fully qualified network address as:
  957.  
  958.                     zone:net/node.point
  959.  
  960.                rather than the usual:
  961.  
  962.                     zone:net/node
  963.  
  964.                The fully qualified address is generated as follows:
  965.  
  966.                     zone -  from the zone in the CONFIG.DOG file, otherwise
  967.                          it defaults to zone 1.
  968.                     net - from the net listed on the -BOSSNODE= line.
  969.                     node - from the node listed on the -BOSSNODE= line.
  970.                     point - from the node listed in the primary address
  971.                          found in the system information file (see section
  972.                          entitled "Required Files").
  973.  
  974.                For example, if the primary address is 1:1014/1, and the
  975.                line -BOSSNODE=132/101 appeared in the AREAS.BBS file, then
  976.                the fully qualified address would be 1:132/101.1
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.                                     Page 15
  990.  
  991.  
  992.       Conference Mail System Revision 4.00                 August 23, 1988
  993.  
  994.      Creating a "Secure" Environment:
  995.  
  996.           For the  purposes of  this section,  a "secure"  system  will  be
  997.           defined as: one accepting echomail only from sources which can be
  998.           verified. In  other  words,  a  "hacker"  cannot  enter  echomail
  999.           messages without getting caught.
  1000.  
  1001.           In order  to create a secure system, the ways in which a "hacker"
  1002.           can enter  echomail messages  without being  detected have  to be
  1003.           identified and countered:
  1004.  
  1005.                1. The  first (and most commonly used method) is to create a
  1006.                regular Fidonet  mail message  to a  node running  echomail.
  1007.                This message  is created  with the  various echomail control
  1008.                information lines  in place.  When the receiving system gets
  1009.                the message  it imports  it into a message area based on the
  1010.                AREA: line,  and the  "hacker" has  successfully entered  an
  1011.                echomail message.   The  Conference Mail  System stops  this
  1012.                problem with  the -M  option for  the Import  function.    A
  1013.                regular netmail message will never be imported.
  1014.  
  1015.                2. The  second method  is by  sending ARCmail file attaches.
  1016.                Again, the  receiving system  will unpack  the  ARCmail  and
  1017.                import it  into the  message areas based on the AREA: lines.
  1018.                This is  addressed by the -S option for the Import function.
  1019.                If the  system sending  the message  does not  appear in the
  1020.                AREAS.BBS file for the conference, the message is redirected
  1021.                to the netmail area for the sysop.
  1022.  
  1023.                3. The  third method is to send ARCmail file attaches with a
  1024.                net/node number  that is  known to be in the AREAS.BBS file.
  1025.                This would  not get  caught by  the checking  done  to  stop
  1026.                number 2, and therefore is the most difficult to detect. The
  1027.                Conference Mail  System addresses  this by  allowing ARCmail
  1028.                packets to  have an  associated password.  The sysops of the
  1029.                two systems exchanging mail decide upon a password and if it
  1030.                is not  present in  the ARCmail, then the secure system will
  1031.                rename the packet and alert the sysop to what transpired.
  1032.  
  1033.           If the  combination of  the Import  -S and  -M options as well as
  1034.           passwording is used, the system is secure.  Because "hackers" are
  1035.           always thinking  up new  ways to  break into  systems, Conference
  1036.           Mail goes  one step further - identifying the perpetrator. When a
  1037.           message is  being exported,  it is analyzed, and if it has traits
  1038.           which tend to make it look like a locally originated message, yet
  1039.           it was not entered locally, the phrase ' Of net/node' is appended
  1040.           to the "From:" field of the message. For example, if a message is
  1041.           being exported  that falls  into this  category, and  it is  from
  1042.           "Scott Tissue",  the exported  messages will be appear to be from
  1043.           "Scott Tissue  Of net/node" where net/node is the net/node number
  1044.           of the system which sent the message.
  1045.  
  1046.           Having the  ability to  impersonate anyone  else when  sending an
  1047.           echomail message  has been abused within FidoNet.  This abuse led
  1048.           to the  security features  mentioned above being made integral to
  1049.           the design  of the  Conference Mail  System. Do not underestimate
  1050.           what might happen to you!  When possible, implement security.
  1051.  
  1052.  
  1053.  
  1054.  
  1055.                                     Page 16
  1056.  
  1057.  
  1058.       Conference Mail System Revision 4.00                 August 23, 1988
  1059.  
  1060.      Why a PATH line?
  1061.  
  1062.           As was  previously mentioned,  the PATH  line is a new concept in
  1063.           Echomail. It  stores the  net/node numbers  of each system having
  1064.           actually processed  a message.  This  information  is  useful  in
  1065.           correcting the  biggest problem  encountered by  nodes running an
  1066.           Echomail compatible  system - the problem of finding the cause of
  1067.           duplicate messages.  How does  the  PATH  line  help  solve  this
  1068.           problem? Take the following path line as an example:
  1069.  
  1070.                ^aPATH: 107/6 107/312 132/101
  1071.  
  1072.           This  shows  the  message  was  processed  by  system  107/6  and
  1073.           transferred to  system 107/312.  It further  shows system 107/312
  1074.           transferred the  message to  132/101, and  132/101  processed  it
  1075.           again. Now take the following path line as the example:
  1076.  
  1077.                ^aPATH: 107/6 107/312 107/528 107/312 132/101
  1078.  
  1079.           This shows  the message  having been processed by node 107/312 on
  1080.           more than one occasion. Based upon the earlier description of the
  1081.           'information control'  fields in  Echomail messages, this clearly
  1082.           is an  error in  processing (see  the section  entitled  "How  it
  1083.           Works"). This  further shows   node  107/528 as  the  node  which
  1084.           apparently processed  the message  incorrectly. In  this case the
  1085.           path line  can be  used to quickly locate the source of duplicate
  1086.           messages.
  1087.  
  1088.           In  a   conference  with  many  participants  it  becomes  almost
  1089.           impossible to  determine the  exact topology used. In these cases
  1090.           the use of the path line can help a coordinator of the conference
  1091.           track any  possible breakdowns in the overall topology, while not
  1092.           substantially increasing  the amount  of information transmitted.
  1093.           Having this  small amount of information added to the end of each
  1094.           message pays  for itself very quickly when it can be used to help
  1095.           detect a  topology  problem  causing  duplicate  messages  to  be
  1096.           transmitted to each system.
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                     Page 17
  1122.  
  1123.  
  1124.       Conference Mail System Revision 4.00                 August 23, 1988
  1125.  
  1126.      Special Situations:
  1127.  
  1128.           The Conference  Mail  System  can  handle  a  number  of  special
  1129.           situations.  Points  and  security  are  two  situations  already
  1130.           mentioned.   Other situations  are  "passthru",  "bad  messages",
  1131.           "routed conferences",  "splitting" a  conference, and "merging" a
  1132.           conference.
  1133.  
  1134.           Passthru:
  1135.  
  1136.                The ZONEGATE  special AREAS.BBS  command  has  already  been
  1137.                mentioned,  but   there  is  one  more  special  feature  of
  1138.                Conference Mail  that can  be utilized by zonegates. This is
  1139.                the ability  to "passthru"  echomail areas without having to
  1140.                retain them.   This  feature is  triggered by a special area
  1141.                name of  "PASSTHRU" listed in the AREAS.BBS file, along with
  1142.                systems to be linked with the area.  The PASSTHRU area works
  1143.                as follows:
  1144.  
  1145.                     1. All  messages that  have an  unrecognized AREA: line
  1146.                     are imported  into the  PASSTHRU area.    The  original
  1147.                     AREA: line  is left intact (normally Import will remove
  1148.                     the AREA:  line when  placing a  message in  a  regular
  1149.                     Conference Mail message base).
  1150.  
  1151.                     2. Export  processes the  PASSTHRU area  like any other
  1152.                     area, with one exception: it does not add an AREA: line
  1153.                     to the messages since the line is already there.
  1154.  
  1155.                     3. Export  does not  update the  seen-by lines  in  the
  1156.                     messages that are retained in the PASSTHRU area.
  1157.  
  1158.                These three  items allow  messages to  simply  pass  thru  a
  1159.                system that  is functioning  as a zone gateway.  The systems
  1160.                on each  side of  the zone  gateway can add areas, and never
  1161.                have to inform the zone gateway.
  1162.  
  1163.                This function is designed ONLY for zone gateways. Other uses
  1164.                should be carefully thought out before implementation.
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                                     Page 18
  1188.  
  1189.  
  1190.       Conference Mail System Revision 4.00                 August 23, 1988
  1191.  
  1192.           Bad Messages:
  1193.  
  1194.                Another special feature of the Conference Mail System is the
  1195.                ability to  have "bad  messages" placed  in a  special area.
  1196.                This allows  the sysop  to analyze  the messages to see what
  1197.                the problems  are, and  then to  fix them.  This feature  is
  1198.                triggered by a special area name of "BAD_MSGS" listed in the
  1199.                AREAS.BBS file.   The  BAD_MSGS directory  will contain  any
  1200.                messages that  could not  be tossed  for some  reason (other
  1201.                than a bad password).  Possibilities are:
  1202.  
  1203.                     1. An uknown area name.
  1204.  
  1205.                     2. The  message is  a duplicate of one of the last 1000
  1206.                     messages in the area.
  1207.  
  1208.                     3. The message is from a node that is not listed in the
  1209.                     AREAS.BBS file, and secure operation was enabled.
  1210.  
  1211.           Routed Conferences:
  1212.  
  1213.                It is  not uncommon  for conference  messages to  be  routed
  1214.                rather than  being sent  directly to  the destination.  This
  1215.                practice is  frowned upon  unless the  system being used for
  1216.                the routing  confirms that  it is alright.  A situation like
  1217.                this can  occur if  a conference  distributor has  a  "free"
  1218.                phone line  and can send to other nodes at a lower cost than
  1219.                sending the  conferences directly.   The ROUTETHRU area name
  1220.                is  a  special  name  reserved  for  this  purpose.    If  a
  1221.                conference message  is received,  and it is not addressed to
  1222.                the current  node,  it  is  then  placed  in  the  directory
  1223.                associated with  the ROUTETHRU area name.  When this area is
  1224.                exported, the  net/node number  of the  receiving system  is
  1225.                taken from  the message  header, rather  than the  AREAS.BBS
  1226.                file, or  the SEEN-BY  lines.   This is  generally a  useful
  1227.                option for network hosts to use.
  1228.  
  1229.           Merging a Conference:
  1230.  
  1231.                In the section entitled "How Conference Mail Works", mention
  1232.                was made  to "cross-linking"  areas, and  how undesirable it
  1233.                was. This section deals with the special case when it is not
  1234.                undesirable. One  such situation arises when a conference is
  1235.                being disbanded  in favor  of another conference on the same
  1236.                topic. In  this  case  it  is  desirable  to  have  the  two
  1237.                conferences merged  together  for  a  period  of  time.  The
  1238.                Conference Mail  System can handle this situation by listing
  1239.                the same  message directory  with two or more different area
  1240.                names in the AREAS.BBS file.  For example, to merge together
  1241.                the TURBO_PASCAL and PASCAL conferences, the following lines
  1242.                would appear in the AREAS.BBS file used by Import:
  1243.  
  1244.                     C:\MSG\PASCAL  TURBO_PASCAL  107/312 136/601
  1245.                     C:\MSG\PASCAL  PASCAL        114/15 161/1
  1246.  
  1247.                Extreme care  should be used when deliberately cross-linking
  1248.                a conference.
  1249.  
  1250.  
  1251.  
  1252.  
  1253.                                     Page 19
  1254.  
  1255.  
  1256.       Conference Mail System Revision 4.00                 August 23, 1988
  1257.  
  1258.           Splitting a Conference:
  1259.  
  1260.                Another special  case arises  when two  systems want to call
  1261.                the same conference by different names.  The Conference Mail
  1262.                System can  handle this  situation the  same way  it handles
  1263.                splitting conference.  The example given above could also be
  1264.                used by  the AREAS.BBS  file used for Export. It would split
  1265.                the conference  into  two  conferences  called  TURBO_PASCAL
  1266.                received by  107/312 and  136/601, and  PASCAL  received  by
  1267.                114/15 and 161/1.
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.                                     Page 20
  1320.  
  1321.  
  1322.       Conference Mail System Revision 4.00                 August 23, 1988
  1323.  
  1324.      CONFERENCE MAIL COMMAND SUMMARY
  1325.  
  1326.      In General:
  1327.  
  1328.           The  Conference  Mail  System  is  driven  by  a  single  program
  1329.           contained in  the executable  file CONFMAIL.EXE. All of the tasks
  1330.           for the  Conference Mail  System are  actually performed  by many
  1331.           sub-functions. In  the section  entitled  "Conference  Mail  Sub-
  1332.           Function Summary",  all sub-function  names should be preceded by
  1333.           the program name. For example:
  1334.  
  1335.                Import -N
  1336.  
  1337.           should be given on the command line as:
  1338.  
  1339.                ConfMail Import -N
  1340.  
  1341.           There is  one special  case where  this is not true: The ConfMail
  1342.           program is capable of taking its input parameters from a "command
  1343.           file."   The sub-function  calls in  this command  file  are  NOT
  1344.           preceded by  the name  'ConfMail'.  To utilize this ability it is
  1345.           necessary to  call the ConfMail program with a second argument of
  1346.           'FILE' and  the third  argument being  the filename  to use  as a
  1347.           command file.   Additional  arguments are  numbered sequentially,
  1348.           and can be used as %1 thru %9 in the command file.  For example:
  1349.  
  1350.                ConfMail FILE ConfMail.CMD 10 ConfMail.Dat
  1351.  
  1352.           Where ConfMail.CMD  may contain  any valid  ConfMail sub-function
  1353.           calls such as:
  1354.  
  1355.                Import -N -F %2 -A PKXARC
  1356.                Export -A PKXARC
  1357.  
  1358.           Any number  of ConfMail  Sub-function calls  may be executed. The
  1359.           command file  is only  aborted if  there is  an abnormal error in
  1360.           processing for any of the functions.
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.                                     Page 21
  1386.  
  1387.  
  1388.       Conference Mail System Revision 4.00                 August 23, 1988
  1389.  
  1390.      Required Files:
  1391.  
  1392.           System Information File:
  1393.  
  1394.                The Conference  Mail System  requires a  system  information
  1395.                file to  be present.  This file is called either MAIL.SYS in
  1396.                the current  directory (Fido  systems),  or  a  file  called
  1397.                CONFIG.DOG in  the directory named by the SEADOG environment
  1398.                variable or the current directory.
  1399.  
  1400.                In the  case of  MAIL.SYS, Fido  creates and  maintains this
  1401.                file for you (refer to the Fido documentation).
  1402.  
  1403.                The CONFIG.DOG file should contain the following:
  1404.  
  1405.                     NODE  zone:net/node
  1406.  
  1407.                          The zone:net/node of the system
  1408.  
  1409.                     MAIL  mailpath
  1410.  
  1411.                          mailpath corresponds  to the  directory containing
  1412.                          the FidoNet mail area.
  1413.  
  1414.                     FILES filepath
  1415.  
  1416.                          filepath corresponds  to  the  directory  used  to
  1417.                          store incoming FidoNet files.
  1418.  
  1419.                     AKA net/node
  1420.  
  1421.                          This statement  is not  required, but  if  present
  1422.                          gives alternate  net/node numbers  for the system,
  1423.                          and  will  include,  by  default,  the  first  AKA
  1424.                          net/node address  in the seen-by lines of exported
  1425.                          messages.
  1426.  
  1427.                     Any other statements in the file area ignored.
  1428.  
  1429.                If your  system does  not have a MAIL.SYS file, then it will
  1430.                be  necessary   to  create   a  CONFIG.DOG  file  using  the
  1431.                statements given  above. The Conference Mail System will not
  1432.                function without one or the other. The CONFIG.DOG file takes
  1433.                precedence if both exist.
  1434.  
  1435.           Origin Line Files:
  1436.  
  1437.                When the  Conference Mail System exports a message that does
  1438.                not have  an Origin  line, one  is appended.  This  line  is
  1439.                normally  formed  from  the  'board  name'  section  of  the
  1440.                AREAS.BBS configuration file being used. This default can be
  1441.                overridden by  having a  file  named  'ORIGIN'  in  the  DOS
  1442.                directory containing  the messages  for a conference. When a
  1443.                message in  the conference  needs to  have  an  Origin  line
  1444.                appended it  will then  be taken  from the first line of the
  1445.                ORIGIN file.
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.                                     Page 22
  1452.  
  1453.  
  1454.       Conference Mail System Revision 4.00                 August 23, 1988
  1455.  
  1456.           Message Identification Database:
  1457.  
  1458.                This is  a file  named CONFDUPS.DAT  that is present in each
  1459.                conference mail  message directory.    IT  SHOULD  NEVER  BE
  1460.                DELETED.   This file contains identification information for
  1461.                the last  1000 messages  to appear in the conference, and it
  1462.                is used  by the  Import  sub-function  to  delete  duplicate
  1463.                messages before  they appear  in  the  conference.    It  is
  1464.                maintained by  the Import  sub-function, and should never be
  1465.                altered or deleted.  It will take up approximately 10K bytes
  1466.                (the  size   of  5  average  messages)  in  each  conference
  1467.                directory.
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.                                     Page 23
  1518.  
  1519.  
  1520.       Conference Mail System Revision 4.00                 August 23, 1988
  1521.  
  1522.      CONFERENCE MAIL SUB-FUNCTION SUMMARY
  1523.  
  1524.      IMPORT:
  1525.  
  1526.      Function:
  1527.  
  1528.           Receives Conference Mail messages and places them into the proper
  1529.           message base (if they are not duplicates of earlier messages).
  1530.  
  1531.      Format:
  1532.  
  1533.           Import [afile] [-K] [-N or -O] [-M] [-S] [-F file]
  1534.                          [-D num_dups] [-A [ARC_cmd]]
  1535.  
  1536.      Options:
  1537.  
  1538.           afile
  1539.  
  1540.                This is the name of the AREAS.BBS file to use for this run.
  1541.  
  1542.           -K
  1543.  
  1544.                Delete NULL messages rather than imported them.
  1545.  
  1546.           -N or -O
  1547.  
  1548.                Specifies imported  messages should  have their date formats
  1549.                changed to the new Opus 1.0 format (-N option), or the older
  1550.                Fido format (-O option). The default is to do no conversion.
  1551.  
  1552.           -M
  1553.  
  1554.                Messages  will   NOT  be  imported  from  the  network  mail
  1555.                directory. This  option is useful for a "secure" environment
  1556.                (see the  section entitled "Advanced Features"). The default
  1557.                is to Import messages from the network mail area.
  1558.  
  1559.           -S
  1560.  
  1561.                Import will  operate in  "secure" mode.  This means messages
  1562.                will not be imported to Conference Mail message bases unless
  1563.                the sending node is listed as a recipient of the conference;
  1564.                the messages  will be  placed into  the  Fidonet  mail  area
  1565.                instead. This  option is  useful for  a "secure" environment
  1566.                (see the section entitled "Advanced Features").
  1567.  
  1568.           -F file
  1569.  
  1570.                Each Conference  Mail area  having a  message imported to it
  1571.                will have  the area  name listed  in the  file named 'file'.
  1572.                This is for correlating the workings of Import and Maint.
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.                                     Page 24
  1584.  
  1585.  
  1586.       Conference Mail System Revision 4.00                 August 23, 1988
  1587.  
  1588.           -D num_dups
  1589.  
  1590.                Allow for  killing duplicates  based on  the last 'num_dups'
  1591.                messages received in each area.  The default for num_dups is
  1592.                1000, and  should only  be decreased.   If  the  default  is
  1593.                increased, there  is a  very good  chance  that  not  enough
  1594.                memory will  be present  in the  default 64K data space, and
  1595.                the program will exit with a warning.
  1596.  
  1597.           -A [ARC_cmd]
  1598.  
  1599.                Import will  attempt to  extract ARCmail  files. The ARC_cmd
  1600.                parameter will  be used  as the command to unARC, and if not
  1601.                given will  default to  'ARC X'. This option MUST be last on
  1602.                the command  line, and  everything following the -A is taken
  1603.                as the unARC command.
  1604.  
  1605.      Errorlevels returned:
  1606.  
  1607.           0 - No messages imported
  1608.           1 - Messages were imported
  1609.           2 - Severe error in processing
  1610.  
  1611.      Examples:
  1612.  
  1613.           To import  messages  without  date  conversion,  and  to  extract
  1614.           ARCmail using the ARC command:
  1615.  
  1616.                Import -A ARC X
  1617.  
  1618.           To import messages in Opus 1.0 format from the netmail area only:
  1619.  
  1620.                Import -N
  1621.  
  1622.           To import messages in Opus 1.0 format and also extract ARCmail
  1623.           using the PKXARC program:
  1624.  
  1625.                Import -N -A PKXARC
  1626.  
  1627.           To use  the file AREAS1.BBS for Importing, create a list of areas
  1628.           having messages Imported into them, and to extract ARCmail (using
  1629.           the default of 'ARC X'):
  1630.  
  1631.                Import AREAS1.BBS -F Conf.Out -A
  1632.  
  1633.           Maximum security  operation of  Import using  ARCE to extract the
  1634.           ARCmail files:
  1635.  
  1636.                Import -M -S -A ARCE
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.                                     Page 25
  1650.  
  1651.  
  1652.       Conference Mail System Revision 4.00                 August 23, 1988
  1653.  
  1654.      EXPORT:
  1655.  
  1656.      Function:
  1657.  
  1658.           Prepares messages  for transmission  to other systems sharing the
  1659.           Conference.
  1660.  
  1661.      Format:
  1662.  
  1663.           Export [afile] [-0/1] [-M #] [-K] [-S #] [-C] [-H]
  1664.                  [-T] [-I] [-Q]  [-R] [-G] [-NF/P] [-O dir]
  1665.                  [-P dir] [-D dir] [-F file] [-A ARC_cmd]
  1666.  
  1667.      Options:
  1668.  
  1669.           afile
  1670.  
  1671.                This is the name of the AREAS.BBS file to use for this run.
  1672.  
  1673.           -0 or -1
  1674.  
  1675.                Use either  the primary  (0) or  alternate (1)  set of  high
  1676.                water marks.  This  can  be  used  in  instances  where  two
  1677.                AREAS.BBS files  are useful.  One such  instance occurs when
  1678.                some nodes  receiving a  conference wish to receive ARCmail,
  1679.                and other nodes do not want ARCmail.
  1680.  
  1681.           -M #
  1682.  
  1683.                Export messages  until '#'  of messages  have been exported.
  1684.                The Conference  Mail System will completely export a message
  1685.                before stopping,  so this  number may  be exceeded  by a few
  1686.                messages.
  1687.  
  1688.           -K
  1689.  
  1690.                Use the  International FidoNet  Association (IFNA)  endorsed
  1691.                "kludge" of  hiding the  AREA and  SEEN-BY  lines  behind  a
  1692.                Control-A character.  This option  should  not  be  used  by
  1693.                systems  which   must  communicate   with   older   echomail
  1694.                compatible systems.
  1695.  
  1696.           -S #
  1697.  
  1698.                Add '#' AKA addresses to the seen-by lines. This number does
  1699.                not include  the primary address which is always included in
  1700.                the seen-by lines. The default is to have 1 AKA included.
  1701.  
  1702.           -C
  1703.  
  1704.                Set the CRASH bit on messages and ARCmail file attaches.
  1705.  
  1706.           -H
  1707.  
  1708.                Set the HOLD bit on messages and ARCmail file attaches
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.                                     Page 26
  1716.  
  1717.  
  1718.       Conference Mail System Revision 4.00                 August 23, 1988
  1719.  
  1720.           -T
  1721.  
  1722.                Strip the  seen-by list  down to  a 'tiny' subset. This list
  1723.                consists of  the current  system, plus  any conference links
  1724.                the system maintains. For example:
  1725.  
  1726.                     System 132/101 maintains links with 107/312 and 136/601
  1727.                     in the  SYSOP conference.   A message is being exported
  1728.                     from that conference, and the current seen-by list is:
  1729.  
  1730.                          SEEN-BY: 107/6 107/312 107/528 120/38 133/1
  1731.  
  1732.                     The new seen-by list would be:
  1733.  
  1734.                          SEEN-BY: 107/312 132/101 136/601
  1735.  
  1736.                This option should be used with EXTREME care. It can cause a
  1737.                topology which had not been generating duplicate messages to
  1738.                suddenly start  generating them.  See the  section  entitled
  1739.                "Troubleshooting" for more information.
  1740.  
  1741.           -I
  1742.  
  1743.                Use internal ARCmailing on Opus systems.
  1744.  
  1745.           -Q
  1746.  
  1747.                Operate in "quiet" mode.
  1748.  
  1749.           -R
  1750.  
  1751.                Send private  conference replies  via netmail.  This  option
  1752.                will cause  messages that  are replies to previous messages,
  1753.                and also  marked private to be sent via netmail, rather than
  1754.                being exported  as a normal Conference Mail message. This is
  1755.                useful for  a conference coordinator, as well as individuals
  1756.                wishing to  reply to  a message  but not  have  all  of  the
  1757.                conference participants see the reply.
  1758.  
  1759.           -G
  1760.  
  1761.                Disable  the   generation  of  the  PATH  line  in  exported
  1762.                messages. Currently  there is  no  need  to  ever  use  this
  1763.                option,  however,   it  is   available  in  case  there  are
  1764.                compatibility problems in the future.
  1765.  
  1766.           -NF
  1767.  
  1768.                Do not  forward messages  that did  not  originate  on  this
  1769.                system. This  option should  only be  used by systems on the
  1770.                end  of   a  topology   chain  (see   the  section  entitled
  1771.                "Conference Topology" for more information).
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.                                     Page 27
  1782.  
  1783.  
  1784.       Conference Mail System Revision 4.00                 August 23, 1988
  1785.  
  1786.           -NP
  1787.  
  1788.                Do not  forward private  messages via echomail. If a private
  1789.                message is encountered, and it is not a reply it will not be
  1790.                sent. If  it is  a reply and the -R switch is not used, then
  1791.                it also  will not  be sent.  If the -R switch is in use, and
  1792.                the message  is marked  private, then  the logic  for the -R
  1793.                switch will be utilized.
  1794.  
  1795.           -O dir
  1796.  
  1797.                For use by Opus 1.0 systems. Place exported messages in .OUT
  1798.                files in  the DOS  directory 'dir'. These messages can later
  1799.                be processed  by oMMM.  This option  MUST be used by systems
  1800.                using Opus 1.0 for outbound FidoNet mail.
  1801.  
  1802.           -P dir
  1803.  
  1804.                Temporary packets  created by the ARCmailing process will be
  1805.                placed in the DOS directory 'dir'. If 'dir' is on a RAM disk
  1806.                processing can  be increased  dramatically. This  option  is
  1807.                also useful if the default directory (the current directory,
  1808.                or one  named by  the SEADOG  environment variable) does not
  1809.                have enough free disk space.
  1810.  
  1811.           -D dir
  1812.  
  1813.                Place the  final ARCmail  files in  the DOS directory 'dir'.
  1814.                This option  is incompatible  with versions below 1.0 of the
  1815.                ARCmail program created by System Enhancement Associates.
  1816.  
  1817.           -F file
  1818.  
  1819.                Takes area  names from 'file' and only exports messages from
  1820.                those areas.
  1821.  
  1822.           -A ARC_cmd
  1823.  
  1824.                Create ARCmail  files using the command 'ARC_cmd'. This MUST
  1825.                be the last option on the command line, and ARC_cmd consists
  1826.                of everything after the -A. The default ARC_cmd is 'ARC A'.
  1827.  
  1828.      Errorlevels returned:
  1829.  
  1830.           0 - All processing terminated normally
  1831.           1 - The maximum number of messages were output (the -M option)
  1832.           2 - Severe error in processing
  1833.  
  1834.      Examples:
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.                                     Page 28
  1848.  
  1849.  
  1850.       Conference Mail System Revision 4.00                 August 23, 1988
  1851.  
  1852.      BATCH FILE EXAMPLES
  1853.  
  1854.           The following  examples  illustrate  several  possible  operating
  1855.           modes for the Conference Mail System. Each example is preceded by
  1856.           a short  paragraph explaining  the system  configuration and  the
  1857.           desired results. The corresponding section of the batch file used
  1858.           to obtain those results is then shown:
  1859.  
  1860.           1. Importing  all messages  including ARCmail  messages into  the
  1861.           Conference Mail  message bases  using the new Opus 1.0 compatible
  1862.           date format.  Conferences  having  messages  imported  then  have
  1863.           maintenance performed  on them. This is a typical installation in
  1864.           the FidoNet network.
  1865.  
  1866.                ConfMail Import -N -F ConfMail.out -A
  1867.                IF ERRORLEVEL 2 GOTO SEVERE
  1868.                IF ERRORLEVEL 1 GOTO DO_MAINT
  1869.                GOTO END_IMPORT
  1870.                :DO_MAINT
  1871.                ReplyLnk -F ConfMail.Out
  1872.                IF ERRORLEVEL 2 GOTO SEVERE
  1873.                GOTO END_IMPORT
  1874.                :SEVERE
  1875.                ECHO Severe Error in Import or Maint
  1876.                :END_IMPORT
  1877.  
  1878.           2. A  "secure" version  of the  above example  (see  the  section
  1879.           entitled  "Advanced  Features"  for  a  discussion  of  a  secure
  1880.           system).
  1881.  
  1882.                ConfMail Import -M -S -N -F ConfMail.out -A
  1883.                IF ERRORLEVEL 2 GOTO SEVERE
  1884.                IF ERRORLEVEL 1 GOTO DO_MAINT
  1885.                GOTO END_IMPORT
  1886.                :DO_MAINT
  1887.                ReplyLnk -F ConfMail.Out
  1888.                IF ERRORLEVEL 2 GOTO SEVERE
  1889.                GOTO END_IMPORT
  1890.                :SEVERE
  1891.                ECHO Severe Error in Import or Maint
  1892.                :END_IMPORT
  1893.  
  1894.           3. Exporting messages from all Conference Mail message bases into
  1895.           ARCmail files.  When exporting  messages send private replies via
  1896.           FidoNet mail.  This is  a typical  installation  in  the  FidoNet
  1897.           network.
  1898.  
  1899.                ConfMail Export -R -A
  1900.                IF ERRORLEVEL 2 GOTO SEVERE
  1901.                GOTO END_EXPORT
  1902.                :SEVERE
  1903.                ECHO Severe Error in Export
  1904.                :END_EXPORT
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.                                     Page 29
  1914.  
  1915.  
  1916.       Conference Mail System Revision 4.00                 August 23, 1988
  1917.  
  1918.           4. Using  AREAS1.BBS for  those systems  receiving  ARCmail,  and
  1919.           AREAS2.BBS  for  those  systems  not  receiving  ARCmail,  export
  1920.           messages from  all  Conference  Mail  message  bases.  For  those
  1921.           systems not receiving ARCmail, send out a maximum of 200 messages
  1922.           during this run. Send private replies via FidoNet mail.
  1923.  
  1924.                REM first handle the nodes that can receive ARCmail
  1925.                ConfMail Export AREAS1.BBS -0 -R -A
  1926.                IF ERRORLEVEL 2 GOTO SEVERE
  1927.                REM now handle those nodes that cannot receive ARCmail
  1928.                ConfMail Export AREAS2.BBS -1 -R -M 200
  1929.                IF ERRORLEVEL 2 GOTO SEVERE
  1930.                GOTO END_EXPORT
  1931.                :SEVERE
  1932.                ECHO Severe Error in Export
  1933.                :END_EXPORT
  1934.  
  1935.           5. Use  a small  RAM disk  for holding  the ARCmail  packet files
  1936.           created during  exporting. Since  the RAM  disk  is  small,  only
  1937.           export 100 messages at a time, but continue on until all messages
  1938.           have been processed. Also create 'tiny' seen-by lines and include
  1939.           no AKA addresses.
  1940.  
  1941.                :LOOP
  1942.                ConfMail Export -M 100 -S 0 -T -P E:\ -A
  1943.                IF ERRORLEVEL 2 GOTO SEVERE
  1944.                IF ERRORLEVEL 1 GOTO LOOP
  1945.                GOTO END_EXPORT
  1946.                :SEVERE
  1947.                ECHO Severe Error in Export
  1948.                :END_EXPORT
  1949.  
  1950.           6. On  an Opus  1.0 system export messages into the Opus outbound
  1951.           directory in  .OUT file  format for later processing by oMMM. Use
  1952.           'tiny' seen-by lines, and send private replies via FidoNet mail.
  1953.  
  1954.                ConfMail Export -O C:\OPUS\OUTBOUND -T -R
  1955.                IF ERRORLEVEL 2 GOTO SEVERE
  1956.                GOTO END_EXPORT
  1957.                :SEVERE
  1958.                ECHO Severe Error in Export
  1959.                :END_EXPORT
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.                                     Page 30
  1980.  
  1981.  
  1982.       Conference Mail System Revision 4.00                 August 23, 1988
  1983.  
  1984.      IMPORTANT NOTICE:
  1985.  
  1986.           In the  past, this  section contained  all kinds  of  words  that
  1987.      basically meant "Don't rip me off, because it is illegal to do so, and
  1988.      if you  use this  product and  it doesn't  work, it  isn't my  fault".
  1989.      Well, that  is still  more or  less true, but there is more now.  Now,
  1990.      ConfMail is being distributed as "GuiltWare <no tm>".  This is a "new"
  1991.      idea that  I came  up with.   Basically, it means that if you use this
  1992.      product, then  you do  what you  can to  help promote  good BBS'ing by
  1993.      other people.   One  aspect of  good BBS'ing  is to say "Thank you" in
  1994.      some way.   For  ConfMail, I would appreciate it if you would send $35
  1995.      to your  favorite local  charity, in  the name of "GuiltWare" and have
  1996.      the charity  acknowledge receipt of your donation to the address given
  1997.      on the title page for Spark Software.  If $35 is too much to ask, then
  1998.      at least  send a thank you note from yourself - even a netmail message
  1999.      will do.  If you cannot do at least that, then GuiltWare fits, because
  2000.      you should feel exceedingly guilty.
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.                                     Page 31
  2046.  
  2047.