home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / t / tmail151.zip / TELEMAIL.DOC < prev    next >
Text File  |  1991-12-15  |  57KB  |  1,423 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.       |
  21.       |
  22.       |  TeleMail - The Telegard Network Mail Interface
  23.       |
  24.       |  Copyright 1990-1991 by Martin Pollard.  All rights reserved.
  25.       |
  26.       |
  27.       |  Version 1.50
  28.       |
  29.       |  Release Date:  15 Dec 1991
  30.       |
  31.       |
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                               ___________________
  45.  
  46.                                TABLE OF CONTENTS
  47.                               ___________________
  48.  
  49.  
  50.       Introduction .................................................... 1
  51.  
  52.       Required Software ............................................... 2
  53.  
  54.       Installing TeleMail ............................................. 3
  55.  
  56.       TeleMail Functions and Options .................................. 4
  57.  
  58.       The TeleMail Setup Utility (TMSETUP) ............................ 9
  59.          System Data .................................................. 10
  60.          Mail Commands ................................................ 12
  61.          Twit Manager ................................................. 13
  62.  
  63.       Using TeleMail .................................................. 15
  64.  
  65.       GroupMail Top Star Conferences .................................. 17
  66.  
  67.       The Message Deletion Feature (aka "Twit Filter") ................ 18
  68.  
  69.       High-Water Marks ................................................ 19
  70.  
  71.       ERRORLEVEL Values ............................................... 21
  72.  
  73.       Recommended Software ............................................ 22
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.                       ____________________________________
  81.  
  82.                        BORING (BUT NECESSARY) LEGAL STUFF
  83.                       ____________________________________
  84.  
  85.  
  86.  
  87.       WARRANTY
  88.  
  89.            This  program is provided as-is, without warranty of any  kind,
  90.            either  expressed or implied, and is only guaranteed to  occupy
  91.            disk  space.  In no event will the author be liable to  you  or
  92.            anyone else for any damages, including (but not limited to) any
  93.            lost profits, lost savings or other incidental or consequential
  94.            damages  arising out of the use of, or inability to  use,  this
  95.            program.
  96.  
  97.            In short:  You're on your own.  If it works for you, great;  if
  98.            not,  or if it breaks something, c'est la vie.  As  the  saying
  99.            goes,  "Use it at your own risk, but if it breaks,  *YOU*  have
  100.            the pieces."
  101.  
  102.  
  103.  
  104.       COPYRIGHT
  105.  
  106.            This program is provided at no cost to you.  However, it is NOT
  107.            public  domain; it is copyrighted by the author.  You may  dis-
  108.            tribute  this program freely, so long as all files in the  dis-
  109.            tribution archive remain intact, without any changes or modifi-
  110.            cations.   The distribution archive is in ZIP format;  however,
  111.            you  may convert the archive to any format you choose, so  long
  112.            as the above requirements are met.
  113.  
  114.  
  115.  
  116.       CREDITS
  117.  
  118.            All  brand  and product names referenced in this  document  are
  119.            trademarks,  registered  trademarks, or  copyrighted  works  of
  120.            their respective holders.
  121.  
  122.            I  would  also like to thank Donald Broadbent,  whose  original
  123.            work and concept provided the basis for TeleMail.  His  efforts
  124.            are gratefully acknowledged and appreciated.
  125.                  TeleMail - The Telegard Network Mail Interface
  126.  
  127.  
  128.                                  ______________
  129.  
  130.                                   INTRODUCTION
  131.                                  ______________
  132.  
  133.       TeleMail is an interface between the Telegard bulletin board  system
  134.       and  FidoNet  standard  NetMail, EchoMail,  and  GroupMail  messages
  135.       (hereafter  referred to collectively as "network  mail").   TeleMail
  136.       will:
  137.  
  138.       *    Read   incoming  network  mail  messages  and  store  them   in
  139.            Telegard's message bases.
  140.  
  141.       *    Scan  Telegard's message bases for outgoing network  mail  mes-
  142.            sages, creating them for further processing and transmission by
  143.            your front-end mailer.
  144.  
  145.       *    Other  functions,  such as purging network mail  messages  that
  146.            have  already  been processed, and packing  outgoing  GroupMail
  147.            messages in Top Star bases.
  148.  
  149.       The  TeleMail  package  also includes  a  menu-driven  configuration
  150.       utility,  TMSETUP,  which allows almost  complete  configuration  of
  151.       TeleMail's operation, from function switches to DOS commands.
  152.  
  153.       Bear in mind that this document is not a tutorial; although it tries
  154.       to present things in as uncomplicated a manner as possible, it  does
  155.       assume that you are at least familiar with the concepts of  FidoNet-
  156.       style  networking and mail processing.  It's a lot of fun, but  it's
  157.       NOT for the faint-of-heart.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                    - Page 1 -
  184.                  TeleMail - The Telegard Network Mail Interface
  185.  
  186.  
  187.                               ___________________
  188.  
  189.                                REQUIRED SOFTWARE
  190.                               ___________________
  191.  
  192.       You will need the following software:
  193.  
  194.       ---  The Telegard BBS software version 2.7.
  195.  
  196.       ---  A  front-end  mailer program.  Front-end mailers take  care  of
  197.            everything  that  has  to do with  transmitting  and  receiving
  198.            mail and files.
  199.  
  200.       ---  If you will be receiving EchoMail conferences, you will need an
  201.            EchoMail processing program (which will pack and unpack message
  202.            bundles and processing messages).
  203.  
  204.       ---  If you will be receiving GroupMail conferences, you will need a
  205.            GroupMail  processing  program and the  ARC  archiving  program
  206.            (from System Enhancement Associates).  Like its EchoMail  cous-
  207.            in,  a GroupMail processor will process incoming  and  outgoing
  208.            GroupMail  bundles.  It also performs other duties specific  to
  209.            GroupMail.
  210.  
  211.       Some of the more popular variations on the above programs are listed
  212.       at  the  end of this document.  However, it is beyond the  scope  of
  213.       this document to provide detailed instructions on the  configuration
  214.       and use of these programs.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                                    - Page 2 -
  243.                  TeleMail - The Telegard Network Mail Interface
  244.  
  245.  
  246.                               _____________________
  247.  
  248.                                INSTALLING TELEMAIL
  249.                               _____________________
  250.  
  251.       Installing TeleMail is a relatively simple job (compared to  setting
  252.       up  network mail itself!).  As this document is more of a  reference
  253.       manual  than a "how-to" book, this installation procedure will  only
  254.       attempt to cover the installation of TeleMail itself.
  255.  
  256.       If  you  haven't already done so, unpack the  TeleMail  distribution
  257.       archive  into  your  main BBS directory.  The only  files  that  are
  258.       ABSOLUTELY  required are TELEMAIL.EXE (the TeleMail program  itself)
  259.       and TMSETUP.EXE (the TeleMail setup utility); all other files may be
  260.       deleted.  Also note that the .EXE files can be placed in any  direc-
  261.       tory  specified in your PATH statement, but TeleMail *MUST* be  exe-
  262.       cuted from the main BBS directory (this is because it needs to  find
  263.       Telegard's   STATUS.DAT   file   in  order   to   obtain   necessary
  264.       information).
  265.  
  266.       TeleMail  requires a configuration file, TELEMAIL.DAT, in  order  to
  267.       run;  thus,  you  should run TMSETUP from the  main  BBS  directory.
  268.       Don't  worry  about  using the program for now;  since  the  default
  269.       options  will  serve for now, just press ESC and answer "Y"  to  the
  270.       "Save  configuration?" question.  TMSETUP will be covered in  detail
  271.       in the next section.
  272.  
  273.       That's it for installation!  (That wasn't so hard, was it?)
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                    - Page 3 -
  302.                  TeleMail - The Telegard Network Mail Interface
  303.  
  304.  
  305.                         ________________________________
  306.  
  307.                          TELEMAIL FUNCTIONS AND OPTIONS
  308.                         ________________________________
  309.  
  310.       If  you  are already familiar with network  mail  processing,  using
  311.       TeleMail will not be difficult at all.  Its command line  parameters
  312.       are patterned after most mail processing utilities, for ease of  use
  313.       and understanding.  The command line syntax is:
  314.  
  315.                 TELEMAIL functions [options]
  316.  
  317.       Functions  tell TeleMail what operations to perform.  AT  LEAST  ONE
  318.       function must be specified in order for TeleMail to work.
  319.  
  320.       TOSS
  321.  
  322.            Takes  messages stored in the message directories  and  inserts
  323.            them  into Telegard's message base files (BRD and  MIX).   This
  324.            function must be done AFTER EchoMail and/or GroupMail has  been
  325.            processed.  While tossing, TeleMail follows these criteria:
  326.  
  327.            ---  1.MSG  files, which are used to store the high-water  mark
  328.                 (explained  later), are skipped, if they exist.  (This  is
  329.                 necessary  only  for EchoMail bases, as 1.MSG is  a  valid
  330.                 message with NetMail and GroupMail.)
  331.  
  332.            ---  As  per  FidoNet specifications, all linefeeds  (ASCII  10
  333.                 decimal, 0A hexadecimal) and soft carriage returns  (ASCII
  334.                 141  decimal, 8D hexadecimal) are removed.  Hard  carriage
  335.                 returns  (ASCII 13 decimal, 0D hexadecimal) and all  other
  336.                 characters are preserved.
  337.  
  338.            ---  ANSI  and 8-bit ASCII characters are converted to  "*"  if
  339.                 the message base is flagged to strip them.   (Technically,
  340.                 network mail messages should not have ANY such characters,
  341.                 but  in  practice,  it's  an  all-too-common   occurrence,
  342.                 particularly  in  countries which use  non-standard  ASCII
  343.                 characters in their alphabets.)
  344.  
  345.            --   All  control  lines,  tear lines,  and  origin  lines  are
  346.                 preserved.
  347.  
  348.            ---  To  prevent the MCI system from inadvertently showing  the
  349.                 user's  personal  information, all "@" characters  in  the
  350.                 FROM, TO, and SUBJECT fields are replaced with "*" charac-
  351.                 ters.
  352.  
  353.            ---  Messages  in GroupMail bases defined as Top  Star  confer-
  354.                 ences  are  not tossed unless TeleMail is told to  do  so.
  355.                 This  feature  is  explained in the  "GroupMail  Top  Star
  356.                 Conferences" section.
  357.  
  358.  
  359.  
  360.                                    - Page 4 -
  361.                  TeleMail - The Telegard Network Mail Interface
  362.  
  363.  
  364.            ---  Inbound  NetMail messages are not deleted after they  have
  365.                 been tossed, unless the "-P" command line option is speci-
  366.                 fied (or the "Delete Inbound NetMail" option is enabled in
  367.                 the configuration file).
  368.  
  369.            ---  TeleMail  will ONLY toss non-local NetMail messages  (i.e.
  370.                 ones which have been received by remote systems).
  371.  
  372.            Messages that are tossed by this function are marked as "sent,"
  373.            so  that  the SCAN function doesn't pick them up  (which  would
  374.            create duplicate messages).
  375.  
  376.       SCAN
  377.  
  378.            Scans the Telegard message files for outgoing messages,  creat-
  379.            ing *.MSG files in the message directories.  This function must
  380.            be done BEFORE any outbound mail processing.
  381.  
  382.            ---  Outgoing  EchoMail  messages are  numbered  starting  from
  383.                 2.MSG,  as  1.MSG  is used to store  the  high-water  mark
  384.                 (explained  later).  NetMail and GroupMail messages  don't
  385.                 have this restriction; therefore, they are numbered start-
  386.                 ing from 1.MSG.
  387.  
  388.            ---  Messages that are marked as "deleted," "not validated," or
  389.                 "sent"  by Telegard are skipped.  The former  are  skipped
  390.                 because,  obviously, the message was deleted or not  vali-
  391.                 dated for a reason; the latter are skipped to avoid creat-
  392.                 ing duplicate messages.
  393.  
  394.            ---  The  conversion of the "center line" and "box line"  codes
  395.                 is  handled  according to the options specified  for  each
  396.                 message base.
  397.  
  398.            ---  MCI color codes are removed from all outgoing messages.
  399.  
  400.            ---  If  a message doesn't contain a tear and/or  origin  line,
  401.                 TeleMail  will  add them (depending on the status  of  the
  402.                 "add tear/origin lines" flag for the message base).
  403.  
  404.            ---  If  a  base is flagged "real names only," real  names  are
  405.                 used in the FROM and TO fields.
  406.  
  407.            ---  If  a base has an address defined that is  different  from
  408.                 the  default address, the defined address is used  in  the
  409.                 message  header and the origin line.  Otherwise,  the  de-
  410.                 fault address is used.
  411.  
  412.            ---  GroupMail  bases defined as Top Star conferences  are  not
  413.                 scanned unless TeleMail is told to do so.  This feature is
  414.                 explained in the "GroupMail Top Star Conferences" section.
  415.  
  416.  
  417.  
  418.  
  419.                                    - Page 5 -
  420.                  TeleMail - The Telegard Network Mail Interface
  421.  
  422.  
  423.            Messages  that  are  scanned by this  function  are  marked  as
  424.            "sent," so that they will not be re-scanned (which would create
  425.            duplicate messages).
  426.  
  427.       PACK
  428.  
  429.            Performs  all the functions of the SCAN command,  but  includes
  430.            bases defined as GroupMail Top Star conferences, in addition to
  431.            all other bases.  This function is discussed in more detail  in
  432.            the "GroupMail Top Star Conferences" section.
  433.  
  434.       PURGE
  435.  
  436.            Removes  all  messages stored in the  message  directories  and
  437.            resets  the high-water marks for each base.  (High-water  marks
  438.            are  explained  later.)  Unless you are using  a  program  that
  439.            manipulates EchoMail and GroupMail messages (such as an offline
  440.            message system), the message directories should be purged  ONLY
  441.            AFTER  THE BASES HAVE BEEN SCANNED FOR OUTGOING  MESSAGES  WITH
  442.            YOUR  ECHOMAIL AND/OR GROUPMAIL PROCESSORS!  (If you purge  the
  443.            directories  before  this is done, you will lose  ALL  of  your
  444.            outgoing  messages.)  There is NO WAY that TeleMail  can  safe-
  445.            guard against this, so use the PURGE function with care!
  446.  
  447.       RESET
  448.  
  449.            Resets the high-water marks of each base to the highest  exist-
  450.            ing  message  in the message directories.  As updating  of  the
  451.            high-water  marks  is  done automatically by  TOSS,  SCAN,  and
  452.            PURGE, this option is not normally needed.  It is provided  for
  453.            use in very rare cases, and should not be used unless you  know
  454.            *EXACTLY* what you are doing!
  455.  
  456.       ALL
  457.  
  458.            Performs the TOSS, SCAN, and PURGE operations in one shot.  ALL
  459.            provides  an alternative to having to specify those three  com-
  460.            mands  on  the command line.  (This function does  NOT  include
  461.            PACK.)  Note that this function should be used ONLY if EchoMail
  462.            and/or GroupMail processing commands are defined in the config-
  463.            uration file (explained later).
  464.  
  465.       Options  tell  TeleMail how to perform its functions.  As  the  name
  466.       suggests, they are optional.  The current available options are:
  467.  
  468.       -B   Normally,  TeleMail's  video output will be  sent  directly  to
  469.            video memory (except when displaying the help screen).  This is
  470.            done  to provide fast screen output.  If your computer  doesn't
  471.            work  properly  with direct screen writes, use  "-B"  to  force
  472.            TeleMail  to use the BIOS video output functions (they  provide
  473.            better compatibility, but they are much slower).
  474.  
  475.  
  476.  
  477.  
  478.                                    - Page 6 -
  479.                  TeleMail - The Telegard Network Mail Interface
  480.  
  481.  
  482.       -D   Enables  the "message deletion" feature (also known as a  "twit
  483.            filter") when performing the TOSS function.  This feature  will
  484.            prevent  messages from selected individuals from being  tossed.
  485.            (Note  that this function DOES NOT remove the  actual  messages
  486.            themselves; it merely prevents the messages from showing up  in
  487.            Telegard's message bases.)  Refer to the "The Message  Deletion
  488.            Feature" section for more details.
  489.  
  490.       -E   Prevents  TeleMail from operating on EchoMail bases, useful  in
  491.            situations where you do NOT want EchoMail to be processed.
  492.  
  493.       -F   Forces the EchoMail and GroupMail scanning commands (defined in
  494.            the  configuration file, discussed later) to be executed,  even
  495.            if  TeleMail  could  not detect any messages that  need  to  be
  496.            exported.   Note that this command does NOT override  the  "-S"
  497.            option.
  498.  
  499.       -G   Prevents TeleMail from operating on GroupMail bases, useful  in
  500.            situations where you do NOT want GroupMail to be processed.
  501.  
  502.       -K   During  a  PURGE operation, TeleMail will attempt to  use  low-
  503.            level DOS functions in order to quickly purge a message  direc-
  504.            tory.  This is known as the "fast" method.  If your system does
  505.            not respond well to the "fast" method, you can use this  option
  506.            to  force  the  "slow" method (used  in  previous  versions  of
  507.            TeleMail, and which should work in ALL circumstances).
  508.  
  509.       -L   During processing, TeleMail will keep a constantly updated  log
  510.            file (defined in the configuration file) detailing every activ-
  511.            ity  performed (the log file is essentially a  reproduction  of
  512.            what  is normally displayed on the screen).  This  option  will
  513.            suppress the creation and/or updating of the log file.
  514.  
  515.       -N   Prevents  TeleMail from operating on NetMail bases,  useful  in
  516.            situations where you do NOT want NetMail to be processed.
  517.  
  518.       -P   Normally, TeleMail will simply mark inbound NetMail messages as
  519.            "received" after they have been tossed.  This option will force
  520.            TeleMail to delete these messages instead.
  521.  
  522.       -Q   TeleMail normally displays very detailed information about what
  523.            it  is doing.  The disadvantage to this is that it  slows  down
  524.            the processing of messages somewhat.  This option will suppress
  525.            all  but  essential  messages  (it does  NOT  affect  log  file
  526.            output), resulting in faster processing.
  527.  
  528.       -S   Prevents  TeleMail from executing the DOS commands  defined  in
  529.            the configuration file (discussed later).  Useful for  perform-
  530.            ing  tests  of the message system  without  disturbing  already
  531.            existing  EchoMail and GroupMail bundles.  (If mail  processing
  532.            commands have not been defined in the configuration file,  this
  533.            option is ignored.)
  534.  
  535.  
  536.  
  537.                                    - Page 7 -
  538.                  TeleMail - The Telegard Network Mail Interface
  539.  
  540.  
  541.       -T   Normally,  TeleMail will not touch message bases designated  as
  542.            GroupMail Top Star conferences.  (This allows the SysOp to take
  543.            advantage  of  the full moderation  facilities  of  GroupMail.)
  544.            This  option tells TeleMail that it's okay to work on Top  Star
  545.            bases.  (Refer to the "GroupMail Top Star Conferences"  section
  546.            for more details.)
  547.  
  548.       -V#  This option controls how detailed TeleMail's log file will  be.
  549.            "#"  can be 0 (minimal), 1 (normal), or 2 (maximum).   Level  1
  550.            (normal  detail)  is the default, and is the  best  choice  for
  551.            everyday  use.  Note that this option has no effect if the  log
  552.            file is disabled (via the "-L" option).
  553.  
  554.       -X   Instructs  TeleMail to ignore the high-water mark when  tossing
  555.            messages.   Note  that this option is rarely used,  as  it  may
  556.            cause duplicate messages in your Telegard message bases.
  557.  
  558.       If no functions are specified, or an incorrect function and/or  option
  559.       is specified, TeleMail will display a help screen, showing abbreviated
  560.       descriptions  of all available functions and options (as well  as  the
  561.       proper command line syntax).
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                                    - Page 8 -
  597.                  TeleMail - The Telegard Network Mail Interface
  598.  
  599.  
  600.                      ______________________________________
  601.  
  602.                       THE TELEMAIL SETUP UTILITY (TMSETUP)
  603.                      ______________________________________
  604.  
  605.       The  TeleMail setup utility (TMSETUP) configures most of  TeleMail's
  606.       operating  parameters (DOS commands, program options, etc.).  It  is
  607.       completely menu-driven for ease of use.
  608.  
  609.       Simply type "TMSETUP" at the DOS prompt to start the program.   Note
  610.       that  you  must be in the main BBS directory, as  TeleMail  requires
  611.       that  the  TELEMAIL.DAT file created by TMSETUP be in the  main  BBS
  612.       directory  (along  with  the  Telegard  STATUS.DAT  file).   Several
  613.       command line switches may be specified with TMSETUP to alter how the
  614.       program operates:
  615.  
  616.            /BIOS     Forces  the  use of BIOS video  routines  instead  of
  617.                      direct  screen  writes,  useful  for  computers  that
  618.                      aren't  100%  IBM PC compatible.  (Do  not  use  this
  619.                      switch otherwise, as it slows down display output.)
  620.  
  621.            /SNOW     Enables  elimination  of "snow" that some  CGA  video
  622.                      cards  produce.  If you see snow on the  screen  when
  623.                      using TMSETUP, this switch will usually eliminate it.
  624.                      (Do not use this switch if your display is  unaffect-
  625.                      ed, as it slows down display output.)
  626.  
  627.            /MONO     If  you are using a monochrome video monitor  with  a
  628.                      CGA  video  card, this switch will  map  all  display
  629.                      codes to black and white so that the output  produced
  630.                      by TMSETUP is more readable.
  631.  
  632.       More  than  one switch may be used by separating them  with  spaces,
  633.       i.e. "TMSETUP /BIOS /MONO".
  634.  
  635.       Once the program is started, the screen will show a copyright notice
  636.       at  the top, a line of text at the bottom, and a menu window in  the
  637.       middle.   This is the Main Menu, as evidenced by the word "Main"  at
  638.       the top of the window (all menu windows are similarly titled).   The
  639.       options available at the Main Menu are:
  640.  
  641.                           System Data
  642.                           Mail Commands
  643.                           Twit Manager
  644.                           Save and Exit
  645.                           Exit
  646.  
  647.       Use the arrow keys to move the cursor bar to the desired option, and
  648.       press  ENTER  to select that option.  To exit the program,  you  can
  649.       select "Save and Exit" (which will save all configuration  options),
  650.       or  "Exit" (you will be prompted to save any changes if  necessary).
  651.       Also, pressing ESC is the same as selecting "Exit".
  652.  
  653.  
  654.  
  655.                                    - Page 9 -
  656.                  TeleMail - The Telegard Network Mail Interface
  657.  
  658.  
  659.       SYSTEM DATA
  660.  
  661.       This  is where most of TeleMail's options are configured.   Use  the
  662.       arrow  keys to move the cursor bar to the desired option, and  press
  663.       ENTER to select that option.  To return to the Main Menu, press ESC.
  664.  
  665.       On  almost  all options, pressing ENTER will instantly  change  that
  666.       option  to the next available value.  Others will  require  keyboard
  667.       input.
  668.  
  669.            Name of Log File
  670.  
  671.                 Defines the name of the file to which TeleMail will  write
  672.                 its  logging information.  The format is identical to  the
  673.                 FrontDoor version 2.x log file; thus, if you like, you can
  674.                 specify  the  name of FrontDoor's log file  instead  of  a
  675.                 separate file.  This way, all of TeleMail's logging infor-
  676.                 mation  will be appended to the FrontDoor log to  consoli-
  677.                 date the information.
  678.  
  679.                 If  you  want  to disable the generation of  a  log  file,
  680.                 simply  erase  (blank out) this  field  completely.   (The
  681.                 default  filename is "TELEMAIL.LOG", prefixed by the  path
  682.                 of your main BBS directory.)
  683.  
  684.            Log Detail Level
  685.  
  686.                 Selects  the  amount of detail written to  the  log  file:
  687.                 minimal,  normal,  or maximum.  Minimal  will  only  write
  688.                 cumulative totals for inbound, outbound, and other  opera-
  689.                 tions;  normal  includes status lines  only  for  affected
  690.                 areas  (the default mode); maximum includes  status  lines
  691.                 for EVERYTHING.
  692.  
  693.                 Note  that  this field cannot be changed if the  log  file
  694.                 name is blank.  Also note that this value can be  overrid-
  695.                 den by the "-Vx" command line option.
  696.  
  697.            Video Output Type
  698.  
  699.                 Tells  TeleMail  how  to write video  output:  via  direct
  700.                 writes  to  video memory (the default mode), or  via  BIOS
  701.                 video  display routines.  The use of BIOS routines is  not
  702.                 recommended unless your system is not 100% IBM PC compati-
  703.                 ble, as video output will be noticably slower.
  704.  
  705.                 Note  that  this  setting can be  overriden  by  the  "-B"
  706.                 command line option.
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.                                    - Page 10 -
  715.                  TeleMail - The Telegard Network Mail Interface
  716.  
  717.  
  718.            Video Output Level
  719.  
  720.                 Selects  how  much  information is written  to  the  video
  721.                 display.   Two  modes are available: normal  (the  default
  722.                 mode)  and  minimal.  In normal mode, the status  of  each
  723.                 message  area being processed is shown; in  minimal  mode,
  724.                 only totals are displayed.  The advantage of minimal  mode
  725.                 is  faster processing, since TeleMail will not spend  time
  726.                 writing information to the video display.
  727.  
  728.                 Note  that  this  setting can be overridden  by  the  "-Q"
  729.                 command line option.
  730.  
  731.            Twit Deletion
  732.  
  733.                 Enables  or  disables the message deletion  function  (the
  734.                 "twit filter"), used to filter out messages from and/or to
  735.                 certain individuals.  This option is disabled by default.
  736.  
  737.                 Note  that  this  setting can be overridden  by  the  "-D"
  738.                 command line option.
  739.  
  740.            Process Top Star Bases
  741.  
  742.                 Enables  or  disables  processing of  GroupMail  Top  Star
  743.                 bases.   If you are the Top Star of one or more  GroupMail
  744.                 conferences  but  operate them in purely  automatic  mode,
  745.                 enabling  this option will save you a considerable  amount
  746.                 of work, as TeleMail will take care of processing automat-
  747.                 ically.  (This option is disabled by default.)
  748.  
  749.                 Note  that  this  option can be  overridden  by  the  "-T"
  750.                 command line option.
  751.  
  752.            Delete Inbound NetMail
  753.  
  754.                 Selects whether or not to delete inbound NetMail after  it
  755.                 has  been tossed into your Telegard NetMail message  base.
  756.                 If  you  do not use an external message  editor,  enabling
  757.                 this option will clean up your NetMail message area by not
  758.                 leaving  any inbound mail there.  If you prefer to use  an
  759.                 external  editor,  or do not have a NetMail  message  base
  760.                 defined  in Telegard, you should disable this option  (the
  761.                 default mode).
  762.  
  763.                 Note  that  this  option can be  overridden  by  the  "-P"
  764.                 command line option.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.                                    - Page 11 -
  774.                  TeleMail - The Telegard Network Mail Interface
  775.  
  776.  
  777.            Force Slow Purge Method
  778.  
  779.                 Selects whether or not to force TeleMail to use the "slow"
  780.                 method  of purging inbound network mail messages.  If  the
  781.                 default  "fast" method is causing problems on your  system
  782.                 (or if it simply doesn't work), enabling this option  will
  783.                 usually  solve  the problem, at a  cost  of  substantially
  784.                 increased  processing  time.  This option is  disabled  by
  785.                 default,  as the "fast" method will usually work  on  most
  786.                 systems.
  787.  
  788.                 Note  that  this  option can be  overridden  by  the  "-K"
  789.                 command line option.
  790.  
  791.  
  792.       MAIL COMMANDS
  793.  
  794.       To run TeleMail in a totally automated fashion, you can define  here
  795.       the  DOS commands used to process inbound and outbound EchoMail  and
  796.       GroupMail  messages,  as  well as a command to  execute  after  mail
  797.       processing is complete and a command to pack GroupMail Top Star base
  798.       messages for distribution.
  799.  
  800.       Use the arrow keys to move the cursor bar to the desired option  and
  801.       press ENTER.  Type the appropriate command line (full pathnames  are
  802.       recommended),  then press ENTER to save it.  Press ESC to return  to
  803.       the Main Menu.
  804.  
  805.            EchoMail Toss
  806.  
  807.                 This is the command used to process inbound EchoMail (and,
  808.                 in  some cases, inbound NetMail) message packets.   It  is
  809.                 executed  during  the TOSS function, just  before  inbound
  810.                 messages  are  imported into the Telegard  message  bases.
  811.                 This command is always executed, regardless of whether  or
  812.                 not any inbound mail packets are present (as TeleMail  has
  813.                 no way of determining such a condition).
  814.  
  815.            EchoMail Scan
  816.  
  817.                 This  is  the command used to  process  outbound  EchoMail
  818.                 (and,  in some cases, outbound NetMail)  message  packets.
  819.                 It  is executed during the SCAN function, just after  mes-
  820.                 sages are exported from the Telegard message bases.   This
  821.                 command  is  executed  ONLY if  TeleMail  detects  pending
  822.                 messages  in  the EchoMail message directories  and/or  if
  823.                 TeleMail exports messages from the Telegard message bases.
  824.  
  825.            GroupMail Toss
  826.  
  827.                 Same  as EchoMail Toss, but applies to  GroupMail  message
  828.                 packets.
  829.  
  830.  
  831.  
  832.                                    - Page 12 -
  833.                  TeleMail - The Telegard Network Mail Interface
  834.  
  835.  
  836.            GroupMail Scan
  837.  
  838.                 Same  as EchoMail Scan, but applies to  GroupMail  message
  839.                 packets.
  840.  
  841.            GroupMail Pack
  842.  
  843.                 This is the command used to pack messages in GroupMail Top
  844.                 Star bases into packets for distribution.  It is  executed
  845.                 during the PACK function, just after messages are exported
  846.                 from  the Telegard message bases (as PACK forces the  SCAN
  847.                 function).   As  with the SCAN function, this  command  is
  848.                 executed ONLY if TeleMail detects pending messages in  the
  849.                 GroupMail  message directories and/or if TeleMail  exports
  850.                 messages from the Telegard message bases.
  851.  
  852.            Post Processing
  853.  
  854.                 This  command  is executed after all  mail  processing  is
  855.                 complete,  just before TeleMail exits to DOS.  It  can  be
  856.                 used  for just about anything you require,  from  creating
  857.                 GroupMail  update  requests to  packing  outbound  NetMail
  858.                 messages.  This command is always executed.
  859.  
  860.       Note  that  all  of these commands can be  suppressed  by  the  "-S"
  861.       command line option.  Also, the EchoMail and GroupMail scan commands
  862.       can be forced (i.e. executed whether or not any pending or  exported
  863.       messages are present) with the "-F" command line option.
  864.  
  865.  
  866.       TWIT MANAGER
  867.  
  868.       TeleMail's message deletion facility (or "twit remover") is used  to
  869.       prevent messages addressed to and/or from specified individuals from
  870.       being imported into Telegard's message bases.  This feature is quite
  871.       helpful  in preventing messages to/from obnoxious  individuals  from
  872.       ever reaching your system.
  873.  
  874.       TMSETUP's Twit Manager is used to add, change, or delete entries  in
  875.       TeleMail's "twit list".  Up to 50 entries can be stored in the  list
  876.       in this release.
  877.  
  878.       Once  this option is selected, you will be shown a window  with  the
  879.       first  entry's  information.  (If there are no entries,  the  window
  880.       will be blank.)  The following keys may be used:
  881.  
  882.            LEFT ARROW     Display the previous entry in the list.  If  you
  883.                           are currently at the first entry, pressing  this
  884.                           key will move to the last entry.
  885.  
  886.            RIGHT ARROW    Display the next entry in the list.  If you  are
  887.                           currently  at the last entry, pressing this  key
  888.                           will move to the first entry.
  889.  
  890.  
  891.                                    - Page 13 -
  892.                  TeleMail - The Telegard Network Mail Interface
  893.  
  894.  
  895.            HOME           Display the first entry in the list.
  896.  
  897.            END            Display the last entry in the list.
  898.  
  899.            INSERT         Insert  a new entry in the list.  This  facility
  900.                           is presented in more detail later.
  901.  
  902.            DELETE         Delete the current entry.
  903.  
  904.            F1             Modify  the  current entry.   This  facility  is
  905.                           presented in more detail later.
  906.  
  907.            ESC            Return to the Main Menu.
  908.  
  909.       Inserting a new entry and modifying an existing entry are  virtually
  910.       identical in operation; the only difference is that inserting a  new
  911.       entry is like modifying a blank entry.  (Think about it for a minute
  912.       and it will become less confusing...)  Thus, both will be  discussed
  913.       simultaneously.
  914.  
  915.       Once  you choose to insert or modify an entry, a cursor bar will  be
  916.       shown at the first field in the window.  Use the arrow keys to  move
  917.       between  fields; press ENTER to modify a field.  Once finished,  you
  918.       can press F10 to save the updated information, or ESC to abandon the
  919.       changes you made.
  920.  
  921.            Name of Twit
  922.  
  923.                 Specifies  the  text  to  compare  against  the  specified
  924.                 field(s)  of inbound messages.  Case is not important,  as
  925.                 TeleMail ignores case during comparisons.
  926.  
  927.            Area Tag
  928.  
  929.                 Specifies  the Telegard message area to which  this  entry
  930.                 applies.   This  allows you to remove  messages  based  on
  931.                 individual  message bases.  (If you want messages  deleted
  932.                 in ALL bases, specify "*ALL*" for the area tag.)
  933.  
  934.            Field to Compare
  935.  
  936.                 Specifies  which field(s) to which TeleMail  will  compare
  937.                 the  text:  From, To, or From/To  (i.e.  both).   Pressing
  938.                 ENTER at this option will cycle between all three values.
  939.  
  940.            Partial Comparison
  941.  
  942.                 Specifies  whether  or not a partial comparison is  to  be
  943.                 performed  with  the  specified text.   For  instance,  if
  944.                 partial comparison is enabled, "MORAVSIK" is specified for
  945.                 the  text,  and  From/To is specified  as  the  comparison
  946.                 fields,  all  messages  to and from  persons  whose  names
  947.                 include the text "MORAVSIK" will be deleted.
  948.  
  949.  
  950.                                    - Page 14 -
  951.                  TeleMail - The Telegard Network Mail Interface
  952.  
  953.  
  954.                                 ________________
  955.  
  956.                                  USING TELEMAIL
  957.                                 ________________
  958.  
  959.       As stated above, TeleMail is designed to be used in conjunction with
  960.       other  EchoMail and GroupMail processing software.  This is  because
  961.       TeleMail is only a translator; other software must be used to  proc-
  962.       ess incoming and outgoing mail bundles (also called "packets").
  963.  
  964.       The best way to accomplish this is with batch files.  For the  exam-
  965.       ples  that  are about to be shown, it is assumed  that  an  EchoMail
  966.       processor is set up to process messages in your BBS directory.   The
  967.       software  used is ConfMail, whose manual contains excellent  discus-
  968.       sions  on  the  topics of EchoMail (any  other  EchoMail  processing
  969.       program can be used; ConfMail is used as an example because it's the
  970.       simplest).   Please  consult  the documentation  for  your  EchoMail
  971.       processor for information on how to properly configure it for  Echo-
  972.       Mail processing.
  973.  
  974.       Our first example is for incoming mail:
  975.  
  976.            ECHO OFF                      { turn off command echoing }
  977.            CD C:\BBS                     { change to BBS directory }
  978.            CONFMAIL IMPORT -A PKUNPAK    { process incoming messages }
  979.            TELEMAIL TOSS                 { put messages into Telegard }
  980.  
  981.       Pretty  simple, wasn't it?  ConfMail takes care of placing  incoming
  982.       messages into their proper spots, and TeleMail takes care of putting
  983.       them into Telegard's message bases.  (The "-A PKUNPAK" in the  Conf-
  984.       Mail  command  line  tells the program to use  PKWARE's  program  to
  985.       unpack any incoming ARCmail bundles.  Refer to the ConfMail documen-
  986.       tation  for  more details on ARCmail.)  This batch  file  should  be
  987.       executed every time a bundle of mail is received; consult the  docu-
  988.       mentation for your front-end mailer on how to do this.
  989.  
  990.       Now, let's see how to process outgoing messages:
  991.  
  992.            ECHO OFF            { turn off command echoing }
  993.            CD C:\BBS           { change to BBS directory }
  994.            TELEMAIL SCAN       { scan Telegard for outgoing }
  995.            CONFMAIL EXPORT     { process outgoing messages }
  996.            TELEMAIL PURGE      { purge remaining messages }
  997.  
  998.       This one's a little more involved.  As you can see, TeleMail is used
  999.       FIRST this time, because Telegard's message bases need to be scanned
  1000.       for outgoing messages before ConfMail takes over.  (Otherwise,  they
  1001.       will be missed entirely by ConfMail.)  After ConfMail processes  the
  1002.       outgoing  messages, they are purged from the message directories  by
  1003.       TeleMail.   This  is done mainly to save disk space; you  can  leave
  1004.       them  alone, if you wish, since both TeleMail and ConfMail will  not
  1005.       touch them in future processing.  (This feat is accomplished through
  1006.       the  use  of high-water marks, explained later.)   This  batch  file
  1007.  
  1008.  
  1009.                                    - Page 15 -
  1010.                  TeleMail - The Telegard Network Mail Interface
  1011.  
  1012.  
  1013.       should be executed before your front-end mailer's "mail events"  are
  1014.       performed;  consult the documentation for your front-end  mailer  on
  1015.       how to do this.
  1016.  
  1017.       Note  that  the ConfMail command line in the above  example  doesn't
  1018.       create  ARCmail  bundles.  This feature can be  added  quite  easily
  1019.       using the "-D" and "-A" command line options (discussed in detail in
  1020.       the  ConfMail documentation).  Note that if you use  PKWARE's  PKPAK
  1021.       program  for  creating ARCmail, you should  use  the  "compatibility
  1022.       mode"  option  "-OCT" so that other archive processors  --  such  as
  1023.       SEA's ARC -- can handle the ARCmail you create.  (Consult the  docu-
  1024.       mentation for PKPAK/PKUNPAK for more details.)
  1025.  
  1026.       Adding GroupMail processing to the above batch files is easy.   Just
  1027.       place the command lines required for GroupMail processing after  the
  1028.       commands  for  EchoMail  processing  (or  before  them;  it  doesn't
  1029.       matter).  You don't need separate TeleMail commands for each;  Tele-
  1030.       Mail handles both at the same time.
  1031.  
  1032.       Note  that  these  are the simplest of  examples;  more  complicated
  1033.       message  processing can be accomplished, if needed, and other  Echo-
  1034.       Mail  processing  programs can be used besides ConfMail.   Also,  as
  1035.       stated  earlier, you can define the external EchoMail and  GroupMail
  1036.       processing  commands  in the configuration file  (to  simplify  your
  1037.       batch  files, and to simplify your message processing  in  general).
  1038.       To help you along, two sample batch files -- MAIL1.BAT and MAIL2.BAT
  1039.       -- are included in the distribution archive.  MAIL1.BAT is an  exam-
  1040.       ple of mail processing without commands defined in the configuration
  1041.       file,  while  MAIL2.BAT  is  an  example  of  mail  processing  with
  1042.       commands  defined.  (You will notice that MAIL2.BAT is  *MUCH*  sim-
  1043.       pler!)  You should examine these batch files and make any  necessary
  1044.       modifications before using them with your setup.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.                                    - Page 16 -
  1069.                  TeleMail - The Telegard Network Mail Interface
  1070.  
  1071.  
  1072.                         ________________________________
  1073.  
  1074.                          GROUPMAIL TOP STAR CONFERENCES
  1075.                         ________________________________
  1076.  
  1077.       One  of GroupMail's biggest advantages is its ability to  allow  the
  1078.       moderator  of  a conference (the "Top Star") to fully  moderate  the
  1079.       messages passing through the conference (i.e. messages can be delet-
  1080.       ed if they are deemed offensive or a violation of conference policy;
  1081.       thus,  since these messages are deleted before they are packed,  the
  1082.       downstream  nodes  will never see them).   However,  since  Telegard
  1083.       doesn't  use FidoNet standard messages, this capability is  severely
  1084.       curtailed... or is it?
  1085.  
  1086.       TeleMail  solves this problem in the following manner.  If a  Group-
  1087.       Mail  Top  Star conference is detected, TeleMail will skip  over  it
  1088.       during  the TOSS, SCAN, PURGE, or RESET functions.  Thus,  both  in-
  1089.       bound  and  outbound  messages can be examined and  acted  upon,  if
  1090.       necessary,  before they are processed.  But, how do we do  that,  if
  1091.       TeleMail won't touch them?  That is where the "-T" option comes  in.
  1092.       When "-T" is specified on the command line (or the Process Top  Star
  1093.       Bases option is enabled in the configuration file), TeleMail will be
  1094.       allowed  to process Top Star bases, allowing both import and  export
  1095.       of messages.
  1096.  
  1097.       There  is one other aspect of Top Star conferences that  we  haven't
  1098.       touched, that of packing them up for pickup.  If the messages aren't
  1099.       packed,  systems  requesting the conference(s) can't pick  them  up.
  1100.       That is where the PACK function comes in.  PACK -- which implies the
  1101.       SCAN function and the "-T" option -- will scan the message bases for
  1102.       outbound messages, including Top Star bases, and execute the  Group-
  1103.       Mail Pack command (if defined in the configuration file) to pack  up
  1104.       the messages.  Note that SCAN and "-T" need not be specified on  the
  1105.       command line when the PACK function is used, since they are  implied
  1106.       by PACK.
  1107.  
  1108.       As those of you who are familiar with GroupMail Top Star conferences
  1109.       can  see,  PACK and "-T" allow complete control over  moderation  of
  1110.       these types of conferences.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                                    - Page 17 -
  1128.                  TeleMail - The Telegard Network Mail Interface
  1129.  
  1130.  
  1131.                __________________________________________________
  1132.  
  1133.                 THE MESSAGE DELETION FEATURE (AKA "TWIT FILTER")
  1134.                __________________________________________________
  1135.  
  1136.       When dealing with network mail conferences, you're inevitably  going
  1137.       to come across this situation.  In one of your favorite  conferences
  1138.       (TREK, for example), there is someone who is so rude, offensive,  or
  1139.       obnoxious,  you don't even want his messages on your system.   (This
  1140.       person is generally referred to as a "twit.")  Unfortunately,  since
  1141.       he's  on  a system halfway across the country, there is  no  way  to
  1142.       prevent the twit from posting in the conference.  How do you  handle
  1143.       such a situation?
  1144.  
  1145.       The  answer is the message deletion feature (also known as  a  "twit
  1146.       filter", as it keeps messages from "twits" out of the system).  When
  1147.       this feature is used, TeleMail will compare a list of names  defined
  1148.       in the configuration file to inbound messages encountered during the
  1149.       TOSS  function.  If any entry matches the criteria you set up  (con-
  1150.       ference  name, from and/or to), that message will not be  placed  in
  1151.       the  Telegard  message base.  In effect, you've just  prevented  the
  1152.       person from posting on your system!
  1153.  
  1154.       Note  that this feature does *NOT* delete the original  message,  as
  1155.       deletion  of  messages (other than by the  conference  moderator  of
  1156.       GroupMail  conferences)  is against FidoNet policy,  and  presumably
  1157.       against the policies of other FidoNet-style networks.  The  messages
  1158.       are  still intact; they've just been prevented from  being  imported
  1159.       into  Telegard's  message bases.  They will still be packed  up  and
  1160.       sent  to  other systems, if the conferences are being fed  to  other
  1161.       nodes.
  1162.  
  1163.       To use this feature, you must first use the Twit Manager in  TMSETUP
  1164.       to enter the name(s) you wish to filter from inbound messages.  (See
  1165.       "The TeleMail Setup Utility" section for more details on how to  use
  1166.       the  Twit  Manager.)  After you define the desired  names,  you  can
  1167.       either  enable  the Twit Deletion option in the  configuration  file
  1168.       (under  System Data in TMSETUP), or use the "-D" option on the  com-
  1169.       mand  line.  From now on, whenever the TOSS function is used,  Tele-
  1170.       Mail  will examine every incoming message and check the criteria  of
  1171.       the deletion file; names that match the criteria will not be  placed
  1172.       in Telegard's message bases.
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                                    - Page 18 -
  1187.                  TeleMail - The Telegard Network Mail Interface
  1188.  
  1189.  
  1190.                                __________________
  1191.  
  1192.                                 HIGH-WATER MARKS
  1193.                                __________________
  1194.  
  1195.       A  high-water  mark is simply a file that stores the number  of  the
  1196.       last message that was processed.  This is done to prevent the  toss-
  1197.       ing  and  scanning  operations from  processing  duplicate  messages
  1198.       (which are not looked upon favorably by SysOps OR conference modera-
  1199.       tors).  TeleMail stores its own high-water mark file,  HI-WATER.MRK,
  1200.       in  each message directory, and uses it to base its own  conclusions
  1201.       about tossing and scanning messages.  Thus, it doesn't conflict with
  1202.       the EchoMail and GroupMail high-water marks.  (High-water marks  are
  1203.       not necessary with NetMail, as TeleMail uses different criteria when
  1204.       processing NetMail.)
  1205.  
  1206.       EchoMail  high-water  marks take the form of a  file  called  1.MSG,
  1207.       which  is a FidoNet standard message.  The only portion of the  file
  1208.       that  matters is the REPLY TO field, which contains  the  high-water
  1209.       message number; the rest of the file is ignored.  (GroupMail handles
  1210.       messages in a slightly different manner than EchoMail, and thus uses
  1211.       a different high-water mark system.)
  1212.  
  1213.       The  EchoMail  1.MSG high-water mark is only  modified  by  TeleMail
  1214.       during  the  PURGE and RESET functions; it is  not  modified  during
  1215.       TOSS.   This  is because the EchoMail processor requires  the  high-
  1216.       water  marks to remain where they are in order for its  scanning  to
  1217.       work properly.
  1218.  
  1219.       Here's an example to illustrate what I mean.  (This can get  confus-
  1220.       ing, so pay CLOSE attention...)  Let's say that your system received
  1221.       an EchoMail bundle that contained three messages for an echo that we
  1222.       are  also feeding to another system.  The message directory  already
  1223.       contains three messages:  2.MSG, 3.MSG, and 4.MSG.  Thus, both high-
  1224.       water marks (1.MSG for the EchoMail processor, and HI-WATER.MRK  for
  1225.       TeleMail) for this echo are already set to 4.
  1226.  
  1227.       Your EchoMail processor stores the incoming messages in the  message
  1228.       directory  as  messages  5.MSG, 6.MSG,  and  7.MSG  (messages  2.MSG
  1229.       through  4.MSG  already exist, as does the 1.MSG  high-water  mark).
  1230.       The EchoMail high-water mark is left alone.  TeleMail then scans the
  1231.       directory and tosses 5.MSG through 7.MSG into the message base.  The
  1232.       TeleMail  high-water mark is set to 7 (since it's the last one  that
  1233.       was processed).  All is well.
  1234.  
  1235.       Now, the bases are being scanned for outgoing messages.   (Remember,
  1236.       we are also feeding messages in this echo to another system, as well
  1237.       as  the system we obtained it from.)  First, TeleMail  is  executed.
  1238.       All bases are scanned, and it finds that our particular echo has two
  1239.       new  messages.  Obeying the TeleMail high-water mark (which is  cur-
  1240.       rently  set  to 7... remember?), TeleMail stores  them  as  messages
  1241.       8.MSG and 9.MSG.  The TeleMail high-water mark is then set to 9  (as
  1242.       9.MSG is the last message processed by TeleMail).
  1243.  
  1244.  
  1245.                                    - Page 19 -
  1246.                  TeleMail - The Telegard Network Mail Interface
  1247.  
  1248.  
  1249.       The EchoMail processor is then used to scan the message  directories
  1250.       for  messages  to be transmitted.  It finds that our echo  has  five
  1251.       messages  that need to be sent out.  This is why the EchoMail  high-
  1252.       water  mark  is NOT touched by TeleMail:  Although the  first  three
  1253.       messages  don't need to be sent to the originating system,  they  DO
  1254.       need to be sent to the system being fed.  (The two new ones need  to
  1255.       be  sent  to BOTH systems, since they originated  on  your  system.)
  1256.       Thus, obeying the EchoMail high-water mark (currently set to 4), the
  1257.       EchoMail processor sends 5.MSG, 6.MSG, and 7.MSG to the system being
  1258.       fed, and 8.MSG and 9.MSG to that system and the originating  system.
  1259.       The EchoMail high-water mark is then set to 9 (as 9.MSG is the  last
  1260.       message scanned by the EchoMail processor).  Thus, we are now  right
  1261.       back where we started!
  1262.  
  1263.       If it all seems confusing at first, don't worry... you're not alone!
  1264.       Every single FidoNet SysOp went through the same ordeals before they
  1265.       understood the EchoMail system.  GroupMail is processed in a similar
  1266.       manner, but overall, it's much simpler than EchoMail.  (The TeleMail
  1267.       high-water  mark, however, works the same way for both EchoMail  and
  1268.       GroupMail.)
  1269.  
  1270.       For a discussion of the fundamental concepts of EchoMail, your  best
  1271.       bet is to consult the documentation for the ConfMail EchoMail  proc-
  1272.       essor.   It contains a lengthy discussion on EchoMail and how it  is
  1273.       processed.  (Your front-end mailer's documentation may also  contain
  1274.       a discussion of EchoMail.)  For a discussion of GroupMail, your best
  1275.       bet is to consult the documentation for the GROUP GroupMail  proces-
  1276.       sor  from System Enhancement Associates.  SEA created the  GroupMail
  1277.       system  (as it applies to FidoNet), and is in the best  position  to
  1278.       describe its details.
  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.                                    - Page 20 -
  1305.                  TeleMail - The Telegard Network Mail Interface
  1306.  
  1307.  
  1308.                               ___________________
  1309.  
  1310.                                ERRORLEVEL VALUES
  1311.                               ___________________
  1312.  
  1313.       TeleMail  will return an ERRORLEVEL of 0 to a running batch file  if
  1314.       all  processing  is completed smoothly.  An ERRORLEVEL of 1  is  re-
  1315.       turned if a fatal error occurs (or if there is a command line syntax
  1316.       error).
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.                                    - Page 21 -
  1364.                  TeleMail - The Telegard Network Mail Interface
  1365.  
  1366.  
  1367.                              ______________________
  1368.  
  1369.                               RECOMMENDED SOFTWARE
  1370.                              ______________________
  1371.  
  1372.       This  list is by no means exhaustive.  It is simply a  reference  to
  1373.       some  of the more popular software that is currently  available  for
  1374.       EchoMail and GroupMail processing, as well as for FidoNet operations
  1375.       in  general.   Note that this is NOT an endorsement of ANY of  these
  1376.       products.   Also note that commercial products are not listed;  only
  1377.       programs available through BBSes (as Shareware, Freeware, or  Public
  1378.       Domain) are included.
  1379.  
  1380.       The  filenames shown below indicate the name of the archive file  in
  1381.       which  the software can usually be found.  Since  different  systems
  1382.       may use different archiving programs (depending on the preference of
  1383.       the  SysOp),  an "*" is used in place of a specific  file  extension
  1384.       (i.e.,  ZIP,  ARC, LZH, ARJ, etc., or even EXE  for  self-extracting
  1385.       archives).
  1386.  
  1387.       FRONT-END MAILERS:
  1388.  
  1389.            BinkleyTerm              2.40      B???_240.LZH
  1390.            D'Bridge                 1.30      DB130*.ZIP
  1391.            FrontDoor                2.02      FD202.ARJ
  1392.  
  1393.       NETMAIL/ECHOMAIL PROCESSORS:
  1394.  
  1395.            ConfMail                 4.00      CONF_400.ZIP
  1396.            Qmail                    1.00      QM_100.ZIP
  1397.            SquishMail               1.00      SQSH_100.LZH
  1398.            Vpurge                   4.09c     VP409C.ZIP
  1399.  
  1400.       GROUPMAIL PROCESSORS:
  1401.  
  1402.            GROUP                    2.23      GROUP222.ARC
  1403.            Gmail                    2.07      GMAIL207.ZIP
  1404.  
  1405.       FILE ARCHIVING UTILITIES:
  1406.  
  1407.            ARC                      6.02      ARC602.EXE
  1408.            ARCA*Simulator           2.20      ASIM_220.ZIP
  1409.            ARJ                      2.22      ARJ222.EXE
  1410.            General Unpack Shell     1.40      GUS_140.ZIP
  1411.            LHA                      2.12      LHA212.EXE
  1412.            PAK                      2.51      PAK251.EXE
  1413.            PKPAK/PKUNPAK            3.61      PK361.EXE
  1414.            PKZIP/PKUNZIP            1.10      PKZ110.EXE
  1415.            PolyXarc                 2.10      PXDOS_21.ZIP
  1416.            ZOO                      2.01      ZOO201.EXE
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.                                    - Page 22 -
  1423.