home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / NETMAIL / FMAIL090.ZIP / FMAIL.DOC < prev    next >
Encoding:
Text File  |  1992-05-09  |  67.3 KB  |  2,232 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    FMail 0.90/gamma
  20.  
  21.  
  22.  
  23.  
  24.                              The Fast Echomail Processor
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                    Copyright (C) 1991, 1992 by Folkert J. Wijnstra
  48.  
  49.                                  All rights reserved
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                   TABLE OF CONTENTS
  56.  
  57.  
  58.  
  59.           1   Introduction  . . . . . . . . . . . . . . . . . . . . . .   3
  60.             1.1   License and disclaimer  . . . . . . . . . . . . . . .   3
  61.             1.2   Registration  . . . . . . . . . . . . . . . . . . . .   4
  62.             1.3   Files . . . . . . . . . . . . . . . . . . . . . . . .   4
  63.             1.4   System requirements . . . . . . . . . . . . . . . . .   5
  64.             1.5   Various notes . . . . . . . . . . . . . . . . . . . .   6
  65.  
  66.           2   Getting started . . . . . . . . . . . . . . . . . . . . .   8
  67.             2.1   Converting config files of other echomail processor .   8
  68.  
  69.           3   FSetup  . . . . . . . . . . . . . . . . . . . . . . . . .   9
  70.               . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  71.             3.1   Main menu . . . . . . . . . . . . . . . . . . . . .    10
  72.             3.2   Miscellaneous . . . . . . . . . . . . . . . . . . .    11
  73.               3.2.1   General options . . . . . . . . . . . . . . . .    11
  74.               3.2.2   Message base  . . . . . . . . . . . . . . . . .    12
  75.               3.2.3   Mail options  . . . . . . . . . . . . . . . . .    14
  76.               3.2.4   Addresses . . . . . . . . . . . . . . . . . . .    14
  77.               3.2.5   Netmail boards  . . . . . . . . . . . . . . . .    15
  78.               3.2.6   AreaMgr Defaults  . . . . . . . . . . . . . . .    15
  79.             3.3   System info . . . . . . . . . . . . . . . . . . . .    16
  80.               3.3.1   Directories . . . . . . . . . . . . . . . . . .    16
  81.               3.3.2   Swapping  . . . . . . . . . . . . . . . . . . .    17
  82.               3.3.3   Compression . . . . . . . . . . . . . . . . . .    18
  83.               3.3.4   Decompression . . . . . . . . . . . . . . . . .    18
  84.               3.3.5   Monochrome  . . . . . . . . . . . . . . . . . .    18
  85.               3.3.6   Extra handles . . . . . . . . . . . . . . . . .    18
  86.             3.4   Import/export . . . . . . . . . . . . . . . . . . .    19
  87.             3.5   Pack manager  . . . . . . . . . . . . . . . . . . .    20
  88.             3.6   Node manager  . . . . . . . . . . . . . . . . . . .    21
  89.             3.7   Area manager  . . . . . . . . . . . . . . . . . . .    23
  90.  
  91.           4   FMail . . . . . . . . . . . . . . . . . . . . . . . . .    26
  92.             4.1   Scan  . . . . . . . . . . . . . . . . . . . . . . .    26
  93.             4.2   Toss  . . . . . . . . . . . . . . . . . . . . . . .    26
  94.             4.3   Import  . . . . . . . . . . . . . . . . . . . . . .    26
  95.             4.4   Pack  . . . . . . . . . . . . . . . . . . . . . . .    28
  96.               4.4.1   Examples  . . . . . . . . . . . . . . . . . . .    28
  97.  
  98.           5   AreaMgr . . . . . . . . . . . . . . . . . . . . . . . .    30
  99.  
  100.           6   FTools  . . . . . . . . . . . . . . . . . . . . . . . .    32
  101.             6.1   Delete  . . . . . . . . . . . . . . . . . . . . . .    32
  102.             6.2   Maint . . . . . . . . . . . . . . . . . . . . . . .    32
  103.             6.3   Move  . . . . . . . . . . . . . . . . . . . . . . .    33
  104.             6.4   Stat  . . . . . . . . . . . . . . . . . . . . . . .    33
  105.  
  106.           7   Credits . . . . . . . . . . . . . . . . . . . . . . . .    34
  107.  
  108.                                           1
  109.  
  110.  
  111.  
  112.  
  113.  
  114.           APPENDIX A  -   Error messages  . . . . . . . . . . . . . .    35
  115.  
  116.           APPENDIX B  -   Technical notes . . . . . . . . . . . . . .    37
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                           2
  168.  
  169.  
  170.  
  171.  
  172.  
  173.           1   Introduction
  174.  
  175.  
  176.  
  177.           FMail is an echomail and netmail processor for the Hudson message
  178.           base. FMail has a built-in AreaFix-like function, called AreaMgr.
  179.           Forwarding  of AreaMgr requests  is not available  in the current
  180.           version but will  be in a future release. Six  different types of
  181.           archives are supported,  one of which is  ARJ. FMail has its  own
  182.           netmail routing function, called the  Pack Manager. With FMail it
  183.           is possible to  make a  copy of  all personal mail  in a  special
  184.           directory. Other features of FMail include:
  185.  
  186.           -   Capable of handling 4D addresses.
  187.  
  188.           -   If  needed FMail automatically remaps fakenet addresses to 4D
  189.               addresses and vice versa.
  190.  
  191.           -   Swaps  to  disk,  EMS  or XMS  before  running  an  archiving
  192.               utility.
  193.  
  194.           -   Supports the message base sharing specifications also used by
  195.               RemoteAccess and FrontDoor.
  196.  
  197.           -   Multiple netmail boards in the message base.
  198.  
  199.           -   Optionally sorts and links messages in the message base after
  200.               new messages have been imported.
  201.  
  202.  
  203.  
  204.           1.1   License and disclaimer
  205.  
  206.  
  207.           "FMail"  refers to  the  executables  and  documentation  in  the
  208.           original distribution archive. FMail  is copyrighted material  by
  209.           Folkert  J. Wijnstra. It  may only be used  in agreement with the
  210.           conditions set out in this license agreement.
  211.  
  212.           Although care  has been  taken to write  and test a  program that
  213.           does what  this document states,  the program is provided  as is,
  214.           without warranty  or guarantee of  any kind, either  expressed or
  215.           implied, as to the quality or performance of this program, except
  216.           that it will occupy disk space.
  217.  
  218.           The  author, Folkert J. Wijnstra, will not  be held liable to you
  219.           or  anyone  for  (but  not  limited  to)  any  direct,  indirect,
  220.           incidental  or consequential damages, including any lost profits,
  221.           lost savings which  may result from  the use or inability  to use
  222.           this program.
  223.  
  224.  
  225.  
  226.                                           3
  227.  
  228.  
  229.  
  230.  
  231.  
  232.           Folkert  J. Wijnstra  is in  no way  obligated to  provide future
  233.           versions of, or support for this software.
  234.  
  235.           Your  use  of the  program  constitutes  your  agreement to  this
  236.           license and  disclaimer and your  release of the author  from any
  237.           form of liability or litigation.
  238.  
  239.  
  240.  
  241.           1.2   Registration 
  242.  
  243.  
  244.           This  public gamma release  (unlike future releases)  may be used
  245.           free of charge for individual hobby use. It is not allowed to use
  246.           this  version  of  FMail within  a  commercial  environment (i.e.
  247.           business, governmental  organization, school, foundation,  or any
  248.           other form of juridical person).
  249.  
  250.           If you like  this program, sending me a netmail  message would be
  251.           appreciated.
  252.  
  253.           Please don't  use crash mail,  but use normal netmail  routing or
  254.           send  your netmail message via node 2:282/1 (+31-5910-34029). You
  255.           can do this by the  following FMail command: FMail Pack 2:282/310
  256.           via 2:282/1. On-line  times for my node number  2:282/310 will be
  257.           published in  the FMAIL_HELP  conference. More  information about
  258.           the availability of this echomail conference can be obtained from
  259.           Rick Kelly (2:282/1) or me.
  260.  
  261.           Folkert J. Wijnstra
  262.           Ede, The Netherlands
  263.           FidoNet 2:282/310 aka 2:283/203.17
  264.  
  265.  
  266.  
  267.           1.3   Files
  268.  
  269.  
  270.           The  FMail echomail  utility package  consists  of the  following
  271.           files:
  272.  
  273.             FMAIL.EXE     The  main program. It  is used for  importing and
  274.                           exporting messages,  packing of  netmail messages
  275.                           and the AreaMgr function.
  276.  
  277.             FSETUP.EXE    Used to create  and update the system  data files
  278.                           and   to   export   them   to  text   files   and
  279.                           configuration files used by other programs.
  280.  
  281.             FTOOLS.EXE    Message base maintenance utility.
  282.  
  283.             FMAIL.DOC     This documentation file.
  284.  
  285.                                           4
  286.  
  287.  
  288.  
  289.  
  290.  
  291.             AREAMGR.HLP   An  example   help   file   that  can   be   sent
  292.                           automatically to  downlinks by  FMail upon  their
  293.                           request.
  294.  
  295.             READ.ME       Additional information about FMail.
  296.            
  297.           The programs  FMail.EXE  and FSetup.EXE  also  create and  use  a
  298.           number of files. These files are:
  299.  
  300.             FMAIL.CFG     General configuration file.
  301.  
  302.             FMAIL.AR      Contains the area configuration used by FMail.
  303.  
  304.             FMAIL.NOD     Contains the node configuration used by FMail.
  305.  
  306.             FMAIL.PCK     Contains the netmail  routing information used by
  307.                           FMail's PACK function.
  308.  
  309.             FMAIL.DUP     Contains the database with signatures of messages
  310.                           used by FMail  to detect messages that  have been
  311.                           sent to  your system  before (duplicates).  FMail
  312.                           keeps track of the last 16384 messages.
  313.  
  314.           FMail will look for  these files in the  directory were FMail  is
  315.           located, even if the current directory is another one.
  316.  
  317.  
  318.  
  319.           1.4   System requirements
  320.  
  321.  
  322.           To use FMail  you need an IBM  PC, AT or 386 or  fully compatible
  323.           computer with a  mono or color card and a harddisk. Also you need
  324.           MS-DOS or PC DOS 3.3 or later. You should have at  least FILES=20
  325.           in your CONFIG.SYS. Use a higher value (e.g. FILES=40) if you are
  326.           using the 'Extra handles' option.
  327.  
  328.           In order to be  able to send and receive mail,  you need a mailer
  329.           that  is compatible with FTSC-0001. For  reading and writing mail
  330.           you need a message editor or a BBS program that uses the QuickBBS
  331.           message base format.
  332.  
  333.           Finally you need  one or more of the  compression programs listed
  334.           below:
  335.  
  336.             ARC     System Enhancement Associates
  337.             ARJ     Robert K Jung
  338.             LHA     Haruyasu Yoshizaki
  339.             PKARC,
  340.             PKPAK,
  341.             PKZIP   PKWARE Inc.
  342.             ZOO     Rahul Dhesi
  343.  
  344.                                           5
  345.  
  346.  
  347.  
  348.  
  349.  
  350.           1.5   Various notes
  351.  
  352.  
  353.  
  354.           *   Internally  FMail always  uses  4  dimensional addresses.  If
  355.               FMail  is handling  mail from  or to  a fakenet  address, the
  356.               address will be  internally converted into the  corresponding
  357.               4-d address. If necessary, the 4-d address will be  converted
  358.               back  into the  fakenet address  if that  is required  by the
  359.               receiving system.
  360.  
  361.               As a  consequence,  all  node  numbers entered  in  the  node
  362.               manager or the area manager should be 4-d addresses !!!
  363.  
  364.           *   Enter your AKAs in FSetup in the same order as in FrontDoor's
  365.               FDSetup,  i.e. if  you have  AKA  3 in  FrontDoor defined  as
  366.               2:282/310,  you  should  also  define  AKA  3  in  FSetup  as
  367.               2:282/310.
  368.  
  369.           *   Fmail doesn't recognize file attach messages created by other
  370.               echomail processors. As a consequence in the beginning  it is
  371.               possible   that  a  second  mail  bundle  is  created  for  a
  372.               particular node  if there is  already a mail bundle  that was
  373.               created by another echomail processor.
  374.  
  375.           *   When entering node numbers in  FSetup or on the FMail command
  376.               line, always  use the 4  dimensional address for  points, not
  377.               the fake net address.
  378.  
  379.           *   Node numbers may  be entered in an abbreviated  way. FMail or
  380.               FSetup will  use the  main node number  to complete  the node
  381.               number.  E.g. if you enter  ".1" and the main  node number is
  382.               defined as  2:282/310, FMail  will use  2:282/310.1. Likewise
  383.               "1" will be changed into 2:282/1.
  384.  
  385.           *   FMail  looks  for  the   de-/compression  utilities  in   the
  386.               directories that are included in the DOS PATH statement.
  387.  
  388.           *   If one or more de-/compression utilities are not available on
  389.               your  system, you should  remove them from  FSetup. That way,
  390.               they will not be mentioned in the AreaMgr confirmation report
  391.               as being available.
  392.  
  393.           *   Packets  created by  FMail are not  recognized by  TosScan as
  394.               being 4D. This may cause problems if FMail is used on a point
  395.               system when the boss uses  TosScan. There are several ways to
  396.               avoid this problem:
  397.  
  398.               -   Use  a utility  that changes  the product  code of  a PKT
  399.                   files created  by FMail to  a code of  a program  that is
  400.                   recognized by TosScan as being 4D.
  401.  
  402.  
  403.                                           6
  404.  
  405.  
  406.  
  407.  
  408.  
  409.               -   Use the 2D fake net method to exchange mail.
  410.  
  411.               Hopefully this problem will be solved in the near future with
  412.               a new release of TosScan.
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                           7
  463.  
  464.  
  465.  
  466.  
  467.  
  468.           2   Getting started
  469.  
  470.  
  471.  
  472.           Use the  DOS command CD to go  to the FrontDoor system directory.
  473.           After you type FSETUP and press the ENTER key, a menu pops up. If
  474.           you use a monochrome monitor  in combination with a video adapter
  475.           with colour capabilities,  you might want to force  FSetup to not
  476.           use any colours. You can do this by appending /M after the FSetup
  477.           command. 
  478.  
  479.  
  480.  
  481.           2.1   Converting config files of other echomail processors
  482.  
  483.  
  484.           FSetup has the capability to  import the configuration files of a
  485.           number  of  other  echomail processors:  IMAIL,  TosScan  and all
  486.           programs  using an AREAS.BBS  file. Before using  this capability
  487.           however,  you first  should enter  all node  numbers you  will be
  488.           using and  include the fake  net numbers you are  using any. This
  489.           way, FMail will  automatically convert all fake net  addresses in
  490.           the configuration files  into 4 dimensional addresses that are be
  491.           used by FMail. 
  492.  
  493.           IMPORTANT: 
  494.  
  495.           1)  Always check the imported configuration files. 
  496.           2)  The  archiver  program  to  be  used will  not  be  converted
  497.               correctly in the node manager!
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.                                           8
  522.  
  523.  
  524.  
  525.  
  526.  
  527.           3   FSetup
  528.  
  529.  
  530.  
  531.           FSetup is the  full screen setup  utility for FMail. FSetup  is a
  532.           menu oriented setup program. The following keys can be used:
  533.  
  534.           -   Move bar to the previous menu entry                  Up arrow
  535.           -   Move bar to the next menu entry                    Down arrow
  536.           -   Select option at the position of the bar                Enter
  537.           -   Return to the previous menu
  538.               (or exit if the current menu is the Main menu)            ESC
  539.           -   Shell to DOS                                            ALT-Z
  540.  
  541.           When editing  a data field  in FSetup, the following  options are
  542.           available to you:
  543.  
  544.           -   Move one position to the left                      Left arrow
  545.           -   Move one position to the right                    Right arrow
  546.           -   Move to the first position 
  547.               of the previous word                          Ctrl-Left arrow
  548.           -   Move to the first position
  549.               of the next word                             Ctrl-Right arrow
  550.           -   Move to the first position of the field                  Home
  551.           -   Move to the last position of the field                    End
  552.  
  553.           -   Delete the character at the 
  554.               current position of the cursor                         Delete
  555.           -   Delete the character left of the cursor             Backspace
  556.           -   Delete rest of the field                             Ctrl-End
  557.           -   Clear the entire field                                 Ctrl-Y
  558.  
  559.           -   Accept contents of data field                           Enter
  560.           -   Restore original contents of data field                   ESC
  561.           -   Toggle insert mode                                     Insert
  562.           -   Shell to DOS                                            ALT-Z
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.                                           9
  581.  
  582.  
  583.  
  584.  
  585.  
  586.           3.1   Main menu
  587.  
  588.  
  589.           The main menu of FSetup contains six options:
  590.  
  591.           Miscellaneous   Allows you to enter general information about the
  592.                           message base and how  messages should be handled.
  593.                           You  also   can  specify   the  compression   and
  594.                           decompression  programs  the should  be used  for
  595.                           your mail.
  596.  
  597.           System info     Information    about    directories,    swapping,
  598.                           compression programs etc. can be entered via  the
  599.                           System info sub menu.
  600.  
  601.           Import/Export   With the Import/Export option  of FSetup you  can
  602.                           export selected  parts of the  configuration to a
  603.                           text file  or a  printer. Also it is  possible to
  604.                           import area and  node configurations of IMAIL and
  605.                           TosScan.
  606.  
  607.           Pack Manager    The pack manager is used to enter netmail routing
  608.                           information. This information is  used by FMail's
  609.                           Pack function.
  610.  
  611.           Node Manager    The node  manager is  used to  review and  update
  612.                           information about other nodes, like the  password
  613.                           for AreaMgr and the node's capability.
  614.  
  615.           Area Manager    The  area manager  is used  to enter  information
  616.                           about echo areas that have to be tossed by FMail.
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.                                           10
  640.  
  641.  
  642.  
  643.  
  644.  
  645.           3.2   Miscellaneous
  646.  
  647.  
  648.           The  "Miscellaneous" menu  contains six  options,  which will  be
  649.           described below.
  650.  
  651.  
  652.           3.2.1   General options
  653.  
  654.           This  options   shows  a  menu   that  lets  you   enter  general
  655.           configuration information:
  656.  
  657.           Sysop Name
  658.  
  659.               Your name. It is used  for determining whether or not netmail
  660.               should be imported into the message base netmail board and if
  661.               a  copy  of an  echomail  message  should  be placed  in  the
  662.               personal mail directory. 
  663.  
  664.           Log file name (optional)
  665.  
  666.               If you want  a log file to  be created, you should  enter the
  667.               desired path and filename here.
  668.  
  669.           AreaMgr log
  670.  
  671.               If you  want a separate log file containing information about
  672.               AreaMgr requests  to be  created, you  should enter  path and
  673.               filename  here. If  left  blank,  information  about  AreaMgr
  674.               requests will be inserted in the normal log file.
  675.  
  676.           Log level
  677.  
  678.               Currently FMail supports three log levels:
  679.               0 :   Nothing will be written to the log file.
  680.               1 :   All information  except the  message 'Tossing  .....PKT
  681.                     from node ....' will be logged.
  682.               2 :   All information will be logged.
  683.  
  684.           Pers. mail path
  685.  
  686.               If you enter a  directory name here, a copy  of each echomail
  687.               message  that is directed  to you (even  if it is  in a pass-
  688.               through  area)  will  be  placed  in  *.MSG  format  in  this
  689.               directory.
  690.  
  691.           Topic 1
  692.           Topic 2
  693.  
  694.               FMail has the  ability to scan the subject  lines of messages
  695.               it is tossing for up  to two keywords. If messages are  found
  696.               containing one of these keywords,  they will be copied to the
  697.  
  698.                                           11
  699.  
  700.  
  701.  
  702.  
  703.  
  704.               personal  mail directory.  Using FMail's  topic  scan feature
  705.               will slow down the tossing function a bit.
  706.  
  707.           Include netmail
  708.  
  709.               Indicates  whether or  not personal  netmail  should also  be
  710.               copied to the personal mail directory.
  711.  
  712.  
  713.           3.2.2   Message base
  714.  
  715.           This option  shows a  menu  that lets  you  control the  way  the
  716.           message base will be handled.
  717.  
  718.           Bad message board
  719.  
  720.               Message base board number of  the board in which bad messages
  721.               will be stored.
  722.  
  723.           Duplicate message board
  724.  
  725.               Message base  board number  of the board  in which  duplicate
  726.               messages will be stored.
  727.  
  728.           Recovery board
  729.  
  730.               Message base board number of  the board to which FTools Maint
  731.               /c  will move  messages in  boards  that are  not defined  in
  732.               FSetup.
  733.  
  734.           Import netmail to sysop
  735.  
  736.               If set to "No", messages addressed to your name or to "Sysop"
  737.               won't be  imported into the message base. Has no effect if no
  738.               netmail board number has been entered.
  739.  
  740.           Remove 'Re:'
  741.  
  742.               Some message editors put "Re:" before the actual subject when
  743.               replying to a message. FMail  is capable to remove "Re:" from
  744.               subject lines.
  745.  
  746.           Remove lf/soft cr
  747.  
  748.               Linefeeds  and  soft  carriage  returns  are  unnecessary  in
  749.               echomail messages. In  order to save some  diskspace, you may
  750.               want to remove them. It  will, however, slow the program down
  751.               a bit.
  752.  
  753.  
  754.  
  755.  
  756.  
  757.                                           12
  758.  
  759.  
  760.  
  761.  
  762.  
  763.           Update text after Scan
  764.  
  765.               Write the  text of the  message as it  will be sent  to other
  766.               systems back to the message base. This means that the message
  767.               in  the   message  base   will  contain   PATH  and   SEEN-BY
  768.               information.
  769.  
  770.           Sort new messages
  771.  
  772.               If set  to "Yes", new  messages in the  message base  will be
  773.               sorted according to subject and date.
  774.  
  775.           Use subject
  776.  
  777.               Apart from date/time also use the subject to sort messages.
  778.  
  779.           Update reply chains
  780.  
  781.               If set  to "Yes",  all message reply  chains will  be updated
  782.               after messages have been tossed into the message base.
  783.  
  784.           Multi-line mode
  785.  
  786.               Allows concurrent access of FMail and the BBS software to the
  787.               message base. DOS's SHARE should be installed.
  788.  
  789.           Scan always
  790.  
  791.               If set to "Yes", the  messages base will always be completely
  792.               scanned for outgoing messages. If set to "No" FMail relies on
  793.               the  files  ECHOMAIL.BBS  and  NETMAIL.BBS  to  indicate  new
  794.               messages.  If these  files  are  found to  be  pointing to  a
  795.               message that doesn't  qualify for export, a  complete scan of
  796.               the message base will be performed.
  797.  
  798.           Quick toss
  799.  
  800.               If enabled, this option slightly shortens  the time needed by
  801.               FMail after  a packet has  been tossed. Normally  the message
  802.               base  files are closed and reopened between packets, but this
  803.               options causes the files not  to be closed. Using this option
  804.               might  under extreme conditions slightly increase the risk of
  805.               loosing some messages in the message base.
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.                                           13
  817.  
  818.  
  819.  
  820.  
  821.  
  822.           3.2.3   Mail options
  823.  
  824.           This  option shows  you  a  menu that  lets  you control  certain
  825.           aspects of the FMail handles mail.
  826.  
  827.           Dupe detection
  828.  
  829.               Try to  detect  duplicate messages.  If found,  they will  be
  830.               placed in the duplicate messages directory (if defined).
  831.  
  832.           Use EMS
  833.  
  834.               Try to use EMS memory to store the signatures of messages in.
  835.               This saves about 64 kb of conventional memory.
  836.  
  837.           Check PKT destination
  838.  
  839.               If this options is  enabled, only packets that are  addressed
  840.               to one of your AKAs (or to one of your points if you are  not
  841.               a point yourself) will be tossed.  Packets addressed to other
  842.               nodes will be  renamed to files with the  file name extension
  843.               '.DST'.
  844.  
  845.           Max PKT size (kb)
  846.  
  847.               The maximum size of an outgoing PKT file in kilobytes.
  848.  
  849.           Keep receipts
  850.  
  851.               Don't set the KILL attribute on receipts created by AreaMgr.
  852.  
  853.           Remove netmail kludges
  854.  
  855.               Some  echomail  processors  cannot handle  echomail  messages
  856.               containing netmail  kludges (INTL,  FMPT, TOPT).  If some  of
  857.               your downlinks use such  an echomail processor, you may  want
  858.               to enable the  'Remove netmail kludges' toggle.  PLEASE CHECK
  859.               THE ECHOMAIL POLICY OF YOUR NET BEFORE USING THIS OPTION.
  860.  
  861.  
  862.           3.2.4   Addresses
  863.  
  864.           Your main address and up to ten other addresses that you may use,
  865.           can be entered in this window. If  some of your points don't have
  866.           4-d capabilities, they will have  to receive their mail using the
  867.           fake net method. For each of the eleven addresses you may enter a
  868.           fake net number. You  can do this by appending it  to your normal
  869.           4-d address using a dash '-'. For example 2:282/310-6310.
  870.  
  871.  
  872.  
  873.  
  874.  
  875.                                           14
  876.  
  877.  
  878.  
  879.  
  880.  
  881.           3.2.5   Netmail boards
  882.  
  883.           FMail allows you to use different netmail boards for each of your
  884.           AKA's. Information about these netmail  areas can be entered in a
  885.           sub menu. The information includes:
  886.           -   Message  base board  number. It  is possible  to use  a board
  887.               number  for more  than one  AKA.  If you  do  this, only  the
  888.               information of the first netmail area that uses a  particular
  889.               message base board will be used, e.g. by AutoExport to create
  890.               the  FrontDoor  and GoldEd  areas  files  and by  FTools  for
  891.               determining which messages should be deleted.
  892.           -   A comment that  will be used in  the areas files that  can be
  893.               created by FSetup AutoExport feature.
  894.           -   Information  that  can be  used  by FTools  for  message base
  895.               maintenance purposes.
  896.           -   Security  information to  be used  in  MESSAGES.RA. For  more
  897.               information about  the options available in the  RA info menu
  898.               you are referred to the RemoteAccess documentation.
  899.  
  900.  
  901.           3.2.6   AreaMgr Defaults
  902.  
  903.           To save  some time when installing new areas in the Area Manager,
  904.           you may enter  a number of default settings that will be used for
  905.           new areas.  Of course, these  values may  be changed in  the Area
  906.           Manager, should  it be necessary. For more  information about the
  907.           offered options, you  are referred to the chapter  about the Area
  908.           Manager.
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.                                           15
  935.  
  936.  
  937.  
  938.  
  939.  
  940.           3.3   System info
  941.  
  942.  
  943.           The system  info menu  is used for  various types  of information
  944.           that are related to the system on which FMail is used.
  945.  
  946.  
  947.           3.3.1   Directories
  948.  
  949.           In  the  'Directories'  window  you  can  enter  eight  paths  to
  950.           directories that will be  used for specific files.  Unless stated
  951.           otherwise, no directory should be used for more than one purpose!
  952.  
  953.           Message base
  954.  
  955.               The message  base  path points  to  the directory  where  the
  956.               message base files are stored.
  957.  
  958.           Netmail
  959.  
  960.               The  netmail  directory contains  netmail  messages  in *.MSG
  961.               format.  File  attach   messages  will  be  placed   in  this
  962.               directory.
  963.  
  964.           Incoming mail
  965.  
  966.               The  incoming  mail  directory is  the  directory  where your
  967.               mailer  stores its received files. Incoming mail bundles will
  968.               also be unpacked in this directory. 
  969.  
  970.               Sometimes for some reason packets are not tossed by FMail. If
  971.               this is  the case, the  PKT files will  be renamed.  The file
  972.               name  extensions of these remaining files indicate the nature
  973.               of the problem:
  974.  
  975.               PKT   If there is not enough free disk space on your harddisk
  976.                     when a incoming PKT  file is being tossed, FMail aborts
  977.                     and  the  PKT  file  remains  in  the  'Incoming  mail'
  978.                     directory.
  979.  
  980.               QQQ   If FMail  for some  reason can't  compress an  outgoing
  981.                     mailbundle, the  file name  extension will  be  changed
  982.                     from PKT into QQQ. If FMail is run again, it will first
  983.                     try to  compress any packets with the  QQQ extension if
  984.                     found.
  985.  
  986.               SEC   The password in this packet did not correspond with the
  987.                     password for the source node in the node manager.
  988.  
  989.               DST   The  mail  packet is  not  directed to  your  main node
  990.                     number or one of your AKAs.
  991.  
  992.  
  993.                                           16
  994.  
  995.  
  996.  
  997.  
  998.  
  999.               ERR   For some reason, the PKT header could not be read.
  1000.  
  1001.           Outgoing mail
  1002.  
  1003.               In  the outgoing  mail directory  FMail  will store  the mail
  1004.               bundles it creates for other nodes.
  1005.  
  1006.           Secure (optional)
  1007.  
  1008.               If you are using some program that creates PKT files that you
  1009.               would like to have tossed by FMail, there may be a problem if
  1010.               you have security enabled in the Area Manager.  Placing those
  1011.               packets  in the  Secure  directory will  cause FMail  to toss
  1012.               them,  even  if  security  is  enabled  for  that  particular
  1013.               echomail conference.
  1014.               CAUTION: Be very careful with what PKT files you place in the
  1015.               Secure directory. It is very easy to create dupes this way!
  1016.  
  1017.           Semaphore (optional)
  1018.  
  1019.               Indicates whether or not FMail should create FDRESCAN.NOW and
  1020.               FMRESCAN.NOW  after  netmail  has  been  tossed.  If  the  FD
  1021.               environment  variable has  been  set,  these  files  will  be
  1022.               created  in   the  directory  indicated  by   this  variable.
  1023.               Otherwise,  they will be  created in  the directory  in which
  1024.               FMail is located.
  1025.  
  1026.           Sent mail (optional)
  1027.           Received mail (optional)
  1028.  
  1029.               If the  'Sent mail'  and/or 'Received  mail' directories  are
  1030.               defined,  FMail will move  sent and/or received  netmail from
  1031.               the netmail directory to the appropriate directory: mail that
  1032.               has been  sent, will be moved to the 'Sent mail' directory if
  1033.               defined. Message  that have  been received  by the  addressee
  1034.               will be moved to the 'Received mail' directory. Messages with
  1035.               special  attributes (file attach,  in-transit) will  never be
  1036.               moved  to  either one  of  these directories.  Sent  mail and
  1037.               Received mail may point to the same directory.
  1038.  
  1039.  
  1040.           3.3.2   Swapping
  1041.  
  1042.           Under some circumstances, there may  not be enough memory left to
  1043.           execute  a (de)compression  utility. To  make sure that  there is
  1044.           enough memory  available, you may  want to enable  swapping. This
  1045.           means that FMail  will temporarily remove  itself from memory  in
  1046.           order to make room for the (de)compression utility.
  1047.  
  1048.           There are three types of  swapping available. The slowest type is
  1049.           swapping to disk.  FMail will try to  swap itself to disk  if the
  1050.           other two methods are not  available. These other two methods are
  1051.  
  1052.                                           17
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.           swapping to EMS and swapping to XMS. If both swapping to  EMS and
  1059.           swapping to XMS are enabled, FMail will first try XMS and if that
  1060.           doesn't work  EMS. If you are  running FMail under DESQview  or a
  1061.           similar  program, make  sure  that  there is  enough  EMS or  XMS
  1062.           available to FMail. Under DESQview  the amount of EMS/XMS that is
  1063.           available in  a window  can be changed  via 'Change  a Program'->
  1064.           'Maximum Expanded Memory Size'. It should be left blank or be set
  1065.           to at least 700 kb.
  1066.  
  1067.           You may set the directory in which the swap file will  be located
  1068.           by entering the path to the desired directory. If left blank, the
  1069.           swap file will be placed in the directory where FMail is located.
  1070.  
  1071.  
  1072.           3.3.3   Compression
  1073.  
  1074.           The programs that are used to compress your outgoing mail bundles
  1075.           are  listed  here.  FMail  can  handle  six  different  types  of
  1076.           archivers: ARC, ZIP, LZH, PAK, ZOO and ARJ. First the name of the
  1077.           program should be listed, followed by optional arguments. Default
  1078.           settings for each of these programs are automatically  created by
  1079.           FSetup when it is run for the first time.
  1080.  
  1081.           It  is important to add the proper  command line switches for the
  1082.           compression utilities. You must make  sure that the programs  are
  1083.           not waiting for additional input  such as a response to a  Yes/No
  1084.           prompt.
  1085.  
  1086.           The archiving utility listed  behind "Default" is used  for nodes
  1087.           not listed in the Node Manager.
  1088.  
  1089.  
  1090.           3.3.4   Decompression
  1091.  
  1092.           The  programs  that are  used  to decompress  your  incoming mail
  1093.           bundles are listed here.  For more information see section  3.3.3
  1094.           (Compression).
  1095.  
  1096.  
  1097.           3.3.5   Monochrome
  1098.  
  1099.           If enabled, FSetup  will not use color,  even if a color  card is
  1100.           detected.  This  may  be  useful on  systems  using  a monochrome
  1101.           monitor in combination with a color card.
  1102.  
  1103.  
  1104.           3.3.6   Extra handles
  1105.  
  1106.           If you have  more than about 10  downlinks and you want  FMail to
  1107.           run faster, you  should enable the  'Extra handles' toggle.  This
  1108.           causes FMail  to use up  to 40 handles  for files instead  of 20.
  1109.           ATTENTION: if you  are running more than one program  at the same
  1110.  
  1111.                                           18
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.           time, please make sure that there are enough handles left for the
  1118.           other programs when FMail is using up to 40 handles.
  1119.  
  1120.  
  1121.  
  1122.           3.4   Import/export
  1123.  
  1124.  
  1125.           All  menu   options  starting  with  "List"  allow  you  to  send
  1126.           information about parts of your FMail setup to a text file  or to
  1127.           the printer. If  you want to send  it to the printer,  just enter
  1128.           PRN as the file name.
  1129.  
  1130.  
  1131.           3.4.1   Import Config
  1132.  
  1133.           The  option "Import  config"  allows  you  to  import  AREAS.BBS,
  1134.           FOLDER.FD and  area and  node configuration  files  of two  other
  1135.           popular  echomail processors:  IMAIL (version  1.20  and up)  and
  1136.           TosScan. In some  cases you have  the choice  whether to use  the
  1137.           area tag or to use the comment to identify an area in the  config
  1138.           file that is created by FSetup.
  1139.  
  1140.           A  special option  is  Import  RA info.  It  imports RA  security
  1141.           information into  an  EXISTING FMail  areas  file. If  you  don't
  1142.           already have an FMail areas file, enter the information  manually
  1143.           in  the Area  Manager or use  one of  the other  import functions
  1144.           first. When you start the Import RA info option, the program will
  1145.           try to find  security information  in MESSAGES.RA  for each  area
  1146.           that is defined in FMail.Ar and insert it in that file.
  1147.  
  1148.  
  1149.           3.4.2   AutoExport
  1150.  
  1151.           Normally when  a new area is installed, this  had to be done in a
  1152.           number of programs. With  FSetup's AutoExport feature this is  no
  1153.           longer   necessary.  Each  update   in  the  Area   Manager  will
  1154.           automatically  result  in  an  update  of  AREAS.BBS,  FOLDER.FD,
  1155.           MESSAGES.RA and a file in a format that can be used by GoldEd.
  1156.  
  1157.           All you have to do is to enter the path to the directory in which
  1158.           the desired file should appear (the actual filename should not be
  1159.           added; FSetup will append a standard name to the path).
  1160.  
  1161.           With FOLDER.FD and MESSAGES.RA  you may choose which item  should
  1162.           be used: the area tag or the comment field.
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.                                           19
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.           3.5   Pack manager
  1177.  
  1178.  
  1179.           Entries  in the Pack  Manager should use  the same  format as the
  1180.           command line when  using the Pack  command. For more  information
  1181.           about this format see section 4.4.
  1182.  
  1183.           Entries in  the Pack  Manager are  used from  top to  bottom: the
  1184.           first entry that applies to a particular message will be used for
  1185.           that message. An example:
  1186.  
  1187.             2:282/357 2:282/309 via 2:282/301
  1188.             2:283/216 via 2:283/203
  1189.             1:* 2:* 3:* 4:* 5:* 6:* via 2:282/1
  1190.             2:282/* /C
  1191.  
  1192.           This  example packs all  messages for nodes  2:282/357, 2:282/309
  1193.           and 2:282/301 that do not have  the crash, hold or orphan  status
  1194.           and  sends them  to node  2:282/301. Messages  for 2:283/216  and
  1195.           2:283/203 are packed  and sent to  node 2:283/203. All  remaining
  1196.           messages for zones 1, 2,  3, 4, 5 and 6 will be  sent to 2:282/1.
  1197.           Crash messages for  nodes in net 282  will be packed and  sent to
  1198.           those nodes directly.
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.                                           20
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.           3.6   Node manager
  1236.  
  1237.  
  1238.           The node manager is used to store information about the nodes you
  1239.           exchange mail with.
  1240.  
  1241.           Node
  1242.  
  1243.               The node number of a node. IMPORTANT: This node number should
  1244.               always be the normal node  number i.e. you should NEVER enter
  1245.               a node  number containing a fake net. If  it is necessary for
  1246.               some  of your  points that you  send them their  mail using a
  1247.               fake net, you should set their capability to "Stone Age" (see
  1248.               below) and define a fake net in the Addresses window.
  1249.  
  1250.           Sysop Name
  1251.  
  1252.               Here you may  enter the name of the sysop of the remote node.
  1253.               A  this moment, the  name of the  sysop will only  be used in
  1254.               AreaMgr replies.
  1255.  
  1256.           Capability
  1257.  
  1258.               You  can tell FMail whether or  not the software of the other
  1259.               node  recognizes   4-d  addresses  (FSC-0039)   or  only  2-d
  1260.               addresses by  setting the capability switch to  "Type 2+" for
  1261.               4-d  or "Stone Age" for 2-d. If  you want to send mail to one
  1262.               of your "Stone  Age" points, FMail will  automatically try to
  1263.               use the fake net method. In most cases setting the capability
  1264.               of a node to Type 2+ will be fine.
  1265.  
  1266.           Archiving utility
  1267.  
  1268.               The "Archiving utility" toggle can be used to set the type of
  1269.               archiving program that will be used to compress mail for this
  1270.               node. A node is able to  change this setting using an AreaMgr
  1271.               request message.
  1272.  
  1273.           Status
  1274.  
  1275.               You may set the status of the file attach messages for a node
  1276.               to "None", "Hold", "Crash", "Hold/Direct" and "Crash/Direct".
  1277.  
  1278.           Groups
  1279.  
  1280.               The area manager lets  you assign a group letter to each echo
  1281.               area. In  the node manager you  can enter the  letters of the
  1282.               groups  that  are available  to a  particular node.  Enter an
  1283.               asterisk if  all areas  should be available  to a  particular
  1284.               node.
  1285.  
  1286.  
  1287.  
  1288.                                           21
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.           Tiny SEEN-BYs
  1295.  
  1296.               If you  set the  "Tiny SEEN-BYs" switch  to "Yes",  this node
  1297.               will receive  echo mail messages  in which only you  and your
  1298.               downlinks  will be  listed in  the  SEEN-BY lines.  In normal
  1299.               situations this switch should be set to "No".
  1300.  
  1301.           Reformat date
  1302.  
  1303.               Some echomail utilities create date  strings which are not in
  1304.               accordance  with  the  specifications.  Some  other  echomail
  1305.               utilities have problems recognizing those date strings. FMail
  1306.               will  send a  corrected date  string to  a node  if "Reformat
  1307.               date" is set to yes.
  1308.  
  1309.           AreaMgr password
  1310.  
  1311.               The AreaMgr password is used  by a remote node to connect  or
  1312.               disconnect echomail areas. To do this, the remote node has to
  1313.               send a message  to "AreaMgr",  "AreaFix" or  "FMail" at  your
  1314.               node number. The password should be on the subject line.
  1315.  
  1316.           Packet password
  1317.  
  1318.               If you enter an Packet password, FMail will only toss packets
  1319.               from  this node  if the  listed  password is  present in  the
  1320.               header of  the received  packet.  The password  also will  be
  1321.               placed in  the header of  each packet created for  this node.
  1322.               The combination of packet password and the Security option in
  1323.               the  Area Manager  should make  it  a bit  more difficult  to
  1324.               successfully drop an echomail bomb on your system.
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.                                           22
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.           3.7   Area manager
  1354.  
  1355.  
  1356.           The area manager is used to tell FMail which echomail conferences
  1357.           (areas)  you  are  carrying.  Each  of the  fields  will  now  be
  1358.           explained in detail.
  1359.  
  1360.           Area name
  1361.  
  1362.               This  is the  name of  the  conference. It  can be  up  to 24
  1363.               characters long. This  name is often referred to  as the area
  1364.               tag.  It is  inserted  into every  message  that your  system
  1365.               exports  for  an   area  so  that  other   system's  echomail
  1366.               processors can put the message  into the correct area when it
  1367.               arrives.
  1368.  
  1369.           Comment
  1370.  
  1371.               This field is  used to give some info  about an echomail area
  1372.               in messages that are returned  by AreaMgr. It also appears in
  1373.               the output of some of the list functions in the Import/export
  1374.               menu.
  1375.  
  1376.           Active
  1377.  
  1378.               If  the 'Active' switch  is off, the  area will  no longer be
  1379.               recognized by FMail as a valid echomail area. This switch can
  1380.               be used to temporarily disable a particular area.
  1381.  
  1382.           Local
  1383.  
  1384.               If you  have local  message areas in  your message  base, you
  1385.               should enter  those areas  in FSetup with  Local set  to Yes.
  1386.               That  way, you can enter message base maintenance information
  1387.               for that area  and make sure, that the  boardnumber cannot be
  1388.               accidentally  assigned to another area. Also those areas will
  1389.               be marked as Local in AutoExported files.
  1390.  
  1391.           Board
  1392.  
  1393.               The "Board"  field is used  to select the message  base board
  1394.               number in which the messages in this area should be imported.
  1395.               If you  select this option,  a window pops up  containing all
  1396.               possible board numbers and the word "None". The board numbers
  1397.               that  are displayed  in a  dark  colour are  already used  by
  1398.               another area.  If you  select the  word "None",  the messages
  1399.               won't be imported into  the message base, but  only forwarded
  1400.               to your downlinks (a so called "Pass-through area").  Use the
  1401.               cursor keys to go to the desired board number and press ENTER
  1402.               to select.
  1403.  
  1404.  
  1405.  
  1406.                                           23
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.           Group
  1413.  
  1414.               The  "Group" field defines  which group a  conference belongs
  1415.               to. The valid range for this field is A through Z.  It's used
  1416.               to regulate the  availability of conferences to  other nodes.
  1417.               You  should  divide   your  conferences  into  a   number  of
  1418.               categories.  For example,  all conferences  that  only a  few
  1419.               people should be able to access could be put into group S for
  1420.               Secure  while all  other  conferences  are  put  into  G  for
  1421.               General.
  1422.  
  1423.           RA info
  1424.  
  1425.               Here you  may enter  the security level  and flags  and other
  1426.               information that will be used in RA's MESSAGES.RA.
  1427.  
  1428.           Security
  1429.  
  1430.               Only messages from  nodes that are connected  to a particular
  1431.               conference are accepted by FMail.
  1432.  
  1433.           Private
  1434.  
  1435.               If the "Private"  field is set to "Yes",  private message are
  1436.               allowed in this  conference. Otherwise, the private  bit will
  1437.               be removed from all messages in this conference.
  1438.  
  1439.           Tiny SeenBy
  1440.  
  1441.               If set to "Yes", all of  your downlinks that are connected to
  1442.               this  area will receive  messages in which  the SEEN-BY lines
  1443.               will only contain your downlinks.
  1444.  
  1445.           Imp. SeenBy
  1446.  
  1447.               If set  to "Yes",  SEEN-BY  information of  messages in  this
  1448.               conference will be imported into the message base.
  1449.  
  1450.           # Messages
  1451.  
  1452.               Maximum  number of  messages in  an area.  If there  are more
  1453.               messages in an area,  they will be deleted as  soon as FTools
  1454.               Maint /d is used.
  1455.  
  1456.           # Days
  1457.  
  1458.               If there  are messages  in an  area that  are older  than the
  1459.               number of days that is entered here, they  will be deleted as
  1460.               soon as FTools Maint /d is used.
  1461.  
  1462.  
  1463.  
  1464.  
  1465.                                           24
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.           Arrival date
  1472.  
  1473.               Use the date that a message arrived on your system instead of
  1474.               the  date that a  message was written  when deleting messages
  1475.               using the  # Days criterium.  This option does not  work with
  1476.               messages  with  an  extremely long  subject  line.  For these
  1477.               messages the date that the message was written will be used.
  1478.  
  1479.           Sysop
  1480.  
  1481.               Do not remove any message that has not been read by the Sysop
  1482.               (the user with the first  entry in Users.BBS). If this switch
  1483.               is set to Yes, no message that has not been read by the SysOp
  1484.               will be deleted, if it should  be deleted according to one or
  1485.               more of the other criteria.
  1486.  
  1487.           Origin
  1488.  
  1489.               The origin is the address that will be added to the  PATH and
  1490.               SEEN-BY lines. It will also used in the origin line that will
  1491.               be appended by FMail if the message that is exported from the
  1492.               message base doesn't contain an origin line (NOTE: FMail will
  1493.               NEVER  add  tear and/or  origin  lines to  messages  that are
  1494.               received from other systems in case they are missing).
  1495.  
  1496.           Other AKAs
  1497.  
  1498.               If you want to add more than one of  your AKAs to the SEEN-BY
  1499.               lines of a  message, you should use the  "Other AKAs" options
  1500.               to indicate which AKAs should be added also.
  1501.  
  1502.           Origin line
  1503.  
  1504.               If a  message that is  exported out of the  message base does
  1505.               not contain  a origin  line, FMail will  add one.  This added
  1506.               origin will contain a text string that may be entered here.
  1507.  
  1508.           Export
  1509.  
  1510.               The systems  connected  to the  conference  are listed  in  a
  1511.               window which pops  up when you  select the option  "Connected
  1512.               systems". IMPORTANT:  The node  number should  always be  the
  1513.               normal node number i.e. you  should NEVER enter a node number
  1514.               containing a fake net. FMail automatically uses the fake  net
  1515.               if necessary.
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.                                           25
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.           4   FMail
  1531.  
  1532.  
  1533.  
  1534.           The actual FMail program has four main commands. They are "Scan",
  1535.           "Toss",  "Import" and  "Pack"  and will  be  discussed in  detail
  1536.           below.
  1537.  
  1538.  
  1539.  
  1540.           4.1   Scan
  1541.  
  1542.  
  1543.           Scan the message base for outgoing echomail and netmail messages.
  1544.           Echomail  messages will  be packet  to  be sent  to other  nodes.
  1545.           Netmail messages will be moved to the netmail directory. They may
  1546.           be packed later by the FMail Pack command discussed below.
  1547.  
  1548.           The Scan option can be used in combination with three switches:
  1549.  
  1550.             /E  Scan for echomail messages only
  1551.             /N  Scan for netmail messages only
  1552.             /S  Scan  the  entire  message  base  (ignore ECHOMAIL.BBS  and
  1553.                 NETMAIL.BBS)
  1554.  
  1555.           ATTENTION: FMail's  SCAN function  does not  yet support  netmail
  1556.           credits.
  1557.  
  1558.  
  1559.  
  1560.           4.2   Toss
  1561.  
  1562.  
  1563.           Tosses received mail bundles into  the message base and  forwards
  1564.           echomail messages to your downlinks. 
  1565.  
  1566.           The /B switch may be added to let FMail check all messages in the
  1567.           bad messages directory  to see  whether they  are valid  echomail
  1568.           messages  or not. This may  necessary if you  are receiving a new
  1569.           conference from your  uplink but forgot to  enter it in  the area
  1570.           manager. Messages that are moved to the message base using the /B
  1571.           switch  will  not be  sent to  your downlinks  as this  may cause
  1572.           duplicate messages to be sent into the net.
  1573.  
  1574.  
  1575.  
  1576.           4.3   Import
  1577.  
  1578.  
  1579.           Imports netmail messages  destined for your node into the message
  1580.           base. A netmail board should be defined in FSetup. Whether or not
  1581.  
  1582.  
  1583.                                           26
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.           messages to the Sysop should  be imported can also be  defined in
  1590.           FSetup. Import has no switches.
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.                                           27
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.           4.4   Pack
  1649.  
  1650.  
  1651.           Packs  and compresses  netmail messages.  These  messages may  be
  1652.           routed through a specified node or may be sent directly.
  1653.  
  1654.           The syntax of FMail Pack:
  1655.  
  1656.             FMail Pack [<node> ... [VIA <node>]
  1657.                            [/C] [/H] [/I] [/L] [/O] ]
  1658.  
  1659.           The one  or more <node>  entries before the optional  VIA specify
  1660.           the nodes for which messages should be packed. The * macro may be
  1661.           used here. E.g. 2:282/* specifies all nodes in net 282 in zone 2.
  1662.           If a VIA node is added,  all messages will be routed though  this
  1663.           node. Otherwise  all messages  will be packed  and sent  to their
  1664.           original destination.
  1665.  
  1666.           The Pack command may be used in combination with five switches:
  1667.  
  1668.             /C  Include messages with Crash status. Normally these messages
  1669.                 will not be packed.
  1670.  
  1671.             /H  Include messages with Hold  status. Normally these messages
  1672.                 will not be packed.
  1673.  
  1674.             /O  Include orphaned messages. Normally these messages will not
  1675.                 be packed.
  1676.  
  1677.             /I  Only  pack messages  that  are  in  transit.  Normally  all
  1678.                 netmail messages destined for other nodes will be packed.
  1679.  
  1680.             /L  Only pack messages that originated on your system. Normally
  1681.                 all  netmail  messages  destined for  other  nodes  will be
  1682.                 packed.
  1683.  
  1684.           If  the command line  does not contain  any node  numbers and VIA
  1685.           information, the information stored in FSetup's Pack Manager will
  1686.           be used. The format of entries in the Pack Manager is the same as
  1687.           described above.
  1688.  
  1689.  
  1690.           4.4.1   Examples
  1691.  
  1692.           In  the examples  below, it is  assumed that 2:282/310  is one of
  1693.           your AKAs.
  1694.  
  1695.           FMail Pack 2:282/1
  1696.  
  1697.               Packs netmail for  2:282/1 and points of that  node and sends
  1698.               it to 2:282/1
  1699.  
  1700.  
  1701.                                           28
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.           FMail Pack 2:282/310
  1708.  
  1709.               Packs  mail for  points of  2:282/310 and  sends it  to those
  1710.               points
  1711.  
  1712.           FMail Pack 2:282/301 2:282/500 via 2:282/1
  1713.  
  1714.               Packs mail  for nodes  2:282/301, 2:282/500  and 2:282/1  and
  1715.               points of those nodes and sends it to 2:282/1
  1716.  
  1717.           FMail Pack 2:282/301 2:282/500
  1718.  
  1719.               Packs  mail for nodes  2:282/301 and 2:282/500  and points of
  1720.               these nodes and sends it to these nodes (mail for points will
  1721.               be sent to their boss)
  1722.  
  1723.           FMail Pack 2:282/1.1 /C
  1724.  
  1725.               Packs mail for point 2:282/1.1  and sends it directly to that
  1726.               point since the  point number  is listed  explicitly. If  you
  1727.               want to route it to the boss of that point, you will have add
  1728.               'via  2:282/1'. Messages with  the Crash status  will also be
  1729.               packed.
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                                           29
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.           5   AreaMgr
  1767.  
  1768.  
  1769.  
  1770.           AreaMgr is a built-in function of FMail that allows other systems
  1771.           to  connect or  disconnect  echomail areas  by  simply sending  a
  1772.           netmail message. 
  1773.  
  1774.           This netmail message should be addressed to  one of your AKAs and
  1775.           directed to 'AreaMgr'  or 'FMail'. For compatibility  reasons the
  1776.           message   may  also  be  directed  to  'AreaFix',  'AreaLink'  or
  1777.           'EchoMgr'. Instead  of the normal  subject, a password  should be
  1778.           entered. For  each system  that will be  allowed to  send AreaMgr
  1779.           messages to your, you should create  an entry in the node manager
  1780.           containing a password.
  1781.  
  1782.           The  message body  of an AreaMgr  request contains  the requested
  1783.           mutations  in  connected  echomail  areas.  To  connect  to  area
  1784.           TEST_AREA you just enter that name  followed by the ENTER key. To
  1785.           disconnect from an  area, just put  a minus  '-' before the  area
  1786.           tag.
  1787.  
  1788.  
  1789.           The format of an AreaLink request:
  1790.  
  1791.  
  1792.              By: <your name>
  1793.              To: AreaMgr (<node number of dest node>)
  1794.              Re: <AreaMgr password>
  1795.              St: Pvt
  1796.              ---------------------------------------------------------
  1797.              [+]<areaname>  To connect to an area
  1798.              -<areaname>    To disconnect from an area
  1799.              %ARCHIVER=xxx  To change  the archiving program used  for your
  1800.                             mail
  1801.              %HELP          To request this message
  1802.              %LIST          To request a list of areas available to you
  1803.              %QUERY         To request a  list of areas  for which  you are
  1804.                             active
  1805.              %UNLINKED      To request a list of areas to which you are not
  1806.                             connected
  1807.              %-ALL          To disconnect from all areas
  1808.              %+ALL          To connect to all available areas
  1809.              [---]          Everything below the tear line is ignored
  1810.  
  1811.  
  1812.  
  1813.           When FMail processes an AreaMgr request message, it will generate
  1814.           a reply,  containing the result  of the request. This  reply will
  1815.           look like this:
  1816.  
  1817.  
  1818.  
  1819.                                           30
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.              By: FMail
  1827.              To: Folkert Wijnstra, FMail Development (2:282/310.1)
  1828.              Re: FMail AreaMgr confirmation report
  1829.              St: Pvt Hold Local
  1830.              ---------------------------------------------------------
  1831.              Confirmation report of connected areas for 2:282/310.1 on     
  1832.                                                              2:282/310
  1833.  
  1834.              Available echo areas:
  1835.  
  1836.              * C_ECHO
  1837.                ENET.SOFT
  1838.              * ENET.SYSOP
  1839.                INTERUSER
  1840.              * NET_DEV
  1841.  
  1842.              * indicates that you are active for this area.
  1843.  
  1844.              You are connected to 3 of 5 available areas.
  1845.  
  1846.              Your mail is being compressed using the ARJ method.
  1847.              Available compression methods are: ARC ZIP LZH PAK ZOO ARJ
  1848.  
  1849.              Use %HELP in a message to FMail for more information.
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.                                           31
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.           6   FTools
  1885.  
  1886.  
  1887.  
  1888.           FTools is the  message base maintenance  program that comes  with
  1889.           FMail.  It is e.g. used  to remove old  messages from the message
  1890.           base and the display information  about the message base.  FTools
  1891.           can be divided into four parts, which will be discussed below.
  1892.  
  1893.  
  1894.  
  1895.           6.1   Delete
  1896.  
  1897.  
  1898.           To delete all messages in a particular board in the message base,
  1899.           enter
  1900.  
  1901.             FTools Delete <board number>
  1902.  
  1903.  
  1904.  
  1905.           6.2   Maint
  1906.  
  1907.  
  1908.           The  most   important  function   of  FTools   is  message   base
  1909.           maintenance. If started  without any switches, FTools  Maint only
  1910.           updates  the  reply   chains  and  recreates  the   index  files.
  1911.           Additional features are available by using command line switches:
  1912.  
  1913.           /C  Recover  messages  in  undefined  boards.  This   means  that
  1914.               messages in message  base boards that are not  defined in the
  1915.               Area Manager  will be  moved to the  recovery board,  if that
  1916.               board was defined in FSetup.  IMPORTANT: If no recovery board
  1917.               number was defined, those messages will be deleted! So please
  1918.               make sure, that your non-echomail boards are also defined  in
  1919.               the Area Manager, with the Active switch set to No.
  1920.  
  1921.           /D  Delete  messages using the  information in the  Area Manager.
  1922.               See section 3.7 for more information about the  criteria that
  1923.               may be used to delete messages.
  1924.  
  1925.           /N  Renumber the message  base. All messages in  the message base
  1926.               will be renumbered. First message will become message #1 etc.
  1927.  
  1928.           /P  Pack (remove deleted messages). When a message in the message
  1929.               base is deleted,  the actual message is still  present in the
  1930.               message base.  It will  only be marked  as being  deleted. In
  1931.               order to keep the message base size within reasonable limits,
  1932.               the message  base has  to be packet  regularly, i.e.  deleted
  1933.               messages are removed from the message base.
  1934.  
  1935.  
  1936.  
  1937.                                           32
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.           /R  Remove "Re:"  from subject lines.  Some editors put  "Re:" in
  1944.               front of  the actual subject  line, when a reply  is written.
  1945.               This switch allows you to remove it.
  1946.  
  1947.           /U  Undelete  deleted  messages.   Deleted  messages  cannot   be
  1948.               undeleted after the message base has been packed.
  1949.  
  1950.  
  1951.  
  1952.           6.3   Move
  1953.  
  1954.  
  1955.           To  move messages from one board to  another board in the message
  1956.           base, enter
  1957.  
  1958.             FTools Move <old board> <new board>
  1959.  
  1960.  
  1961.  
  1962.           6.4   Stat
  1963.  
  1964.  
  1965.           To display message base statistics  which also will be written to
  1966.           the log file, enter
  1967.  
  1968.             FTools Stat
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.                                           33
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.           7   Credits
  2003.  
  2004.  
  2005.  
  2006.           FMail  uses the  SPAWNO 3.0  routines by  Ralf Brown  to minimize
  2007.           memory use while running archiving utilities.
  2008.  
  2009.           The following copyrighted  programs are mentioned in  this manual
  2010.           or in FSetup:
  2011.  
  2012.             ARC         Systems Enhancements Associates
  2013.             ARJ         Robert K. Jung
  2014.             Turbo C     Borland International, Inc.
  2015.             FrontDoor,
  2016.               TosScan   Joaquim Homrighausen
  2017.             GEcho       Gerard van der Land
  2018.             IBM,
  2019.               PC DOS    International Business Machines Corp.
  2020.             IMAIL       Fabiano Fabris
  2021.             LHA         Haruyasu Yoshizaki
  2022.             MicroSoft,
  2023.               MS-DOS    MicroSoft Corporation
  2024.             PAK         NoGate Consulting
  2025.             PKZIP       PKWARE, Inc.
  2026.             QEMM,
  2027.               DESQview  Quarterdeck Office Systems, Inc.
  2028.             QuickBBS    Richard Creighton & Steve Gabrilowitz
  2029.             RemoteAccess, 
  2030.              RA,
  2031.               RAMSG     Andrew Milner
  2032.             XRS         Mike Ratledge
  2033.  
  2034.  
  2035.           I would like to  thank all of my beta  testers for the time  they
  2036.           invested in testing a program that was completely unknown to them
  2037.           at first:
  2038.  
  2039.           Jos Bergman,  Sandra Nooren,  Peter Sykora,  Roelf Renkema,  Alex
  2040.           Brandsma,  Jan   Berends,  Hans  Luiks,   Herman  Kuipers,  Hylko
  2041.           Stockmann,  Willem de Langen,  Peter Kauffman, Kris  Lebacq, Theo
  2042.           Runia,  Aldert van  der Laan,  Sico Bruins,  Ari  Sadarjoen, Henk
  2043.           Noppe, Peter van der Steen, Reijer Grisnigt, Gerrit Oberink, Henk
  2044.           Catsburg, Hans de  Vor, Jack Raats, Klaas Haan,  Piet Kampen, Wil
  2045.           de Groot,  Jean Cremers, Gerben Cadee, Peter  Kelders, Pierre van
  2046.           Geyt, Tom  Jansma, Rene  van der Bron,  Jan Marten  Eric Elzinga,
  2047.           Severinus  Planting, Albert Siersema, Ronald Faber, Ad Wisse, Cor
  2048.           Doornbos, Tanja Gommers, Ben van Looy, Feico de Boer, Rick Kelly,
  2049.           Henk van  de Weerdt, Jan  Hoolwerf, Peter Lindeman,  Jan Winters,
  2050.           Ivan  Ferrol,   Stefan  Franck,  Urbaan   Schoonderwoerd,  Marcel
  2051.           Bolhuis,  Harry van  Tilburg, Peter  van  Dolderen, Ron  Baltzer,
  2052.           Harold  Schuring, Art  Laarman, Raf  van Hoof  and (last  but not
  2053.           least) Gerard van der Land.
  2054.  
  2055.                                           34
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.           APPENDIX A  -   Error messages
  2062.  
  2063.  
  2064.  
  2065.           Below  some of  FMail's error  messages are  listed with  a brief
  2066.           explanation.
  2067.  
  2068.           Bad node in pack list
  2069.  
  2070.               There was a syntax error in the list of nodes that  should be
  2071.               packed.
  2072.  
  2073.           Bad VIA node
  2074.  
  2075.               There  was  a syntax  error  in  the  node number  after  the
  2076.               optional VIA keyword.
  2077.  
  2078.           Can't lock the message base for update
  2079.  
  2080.               FMail  couldn't  lock  the  message  base  for  update  in  a
  2081.               multiline environment. If after several  retries this message
  2082.               doesn't go away,  reboot your computer, because  some program
  2083.               may have locked the message base without unlocking it when it
  2084.               was finished.
  2085.  
  2086.           Can't read FMAIL.CFG
  2087.  
  2088.               FMail  couldn't find  FMAIL.CFG in  the  directory where  the
  2089.               currently running executable in located.
  2090.  
  2091.           Disk-related error
  2092.  
  2093.               FMail has a problem reading  or writing some file. This might
  2094.               be caused by a full disk.
  2095.  
  2096.           FMail requires at least DOS 3.3
  2097.  
  2098.               Some functions  of FMail require  the presence of DOS  3.3 or
  2099.               higher. DR DOS should also work.
  2100.  
  2101.           Main nodenumber not defined in FSetup
  2102.  
  2103.               You  should always  define the  main node  number in  FSetup;
  2104.               FMail won't work without one!
  2105.  
  2106.           Packet is addressed to another node
  2107.  
  2108.               A PKT file  is not addressed to  your main node number  or to
  2109.               one of your AKAs.
  2110.  
  2111.  
  2112.  
  2113.  
  2114.                                           35
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.           Packet password violation
  2121.  
  2122.               A PKT file contained a wrong  password or no password at all,
  2123.               although a password was set  for the source node in  the node
  2124.               manager.
  2125.  
  2126.           Warning: Fake net not defined but required for AKA xx
  2127.  
  2128.               You are trying  to send  mail to  a point  system, which  was
  2129.               configured in the Node Manager as being a "Stone Age" system,
  2130.               and thus requiring a fake net number which was not defined.
  2131.  
  2132.           Warning: Node xxx is not defined in the Node Manager
  2133.  
  2134.               You are trying to send mail to a node  which is not listed in
  2135.               the Node Manager. As a  consequence, FMail does not know what
  2136.               the capability  of the  remote system  is, which  compression
  2137.               program should be used  and status the resulting file  attach
  2138.               message  should have.  If this  is the  case, FMail  will use
  2139.               default values.
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.                                           36
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.           APPENDIX B  -   Technical notes
  2180.  
  2181.  
  2182.  
  2183.           *   The  FTSC assigned  product code  for  FMail is  0x81 (=  129
  2184.               decimal).
  2185.  
  2186.           *   FMail can handle upto 500 echomail conferences of which  upto
  2187.               200 may be imported into the message base.
  2188.  
  2189.           *   FMail is fully zone and point aware.
  2190.  
  2191.           *   The  mail packets created by FMail are FTS-0001, FTS-0004 and
  2192.               FSC-0039 compatible, using  the Type 2+ packet header and the
  2193.               Capability Word.  FMail also  recognizes Type 2.2  (FSC-0045)
  2194.               packet headers.
  2195.  
  2196.           *   If an AREA: tag is preceded  by a ^A, it is still  recognized
  2197.               by FMail. Also tags in lower case are recognized.
  2198.  
  2199.           *   SEEN-BY and PATH lines are  created and updated, but they are
  2200.               not used by FMail for duplicate detection purposes.
  2201.  
  2202.           *   FMail can parse both Fido/Opus and SEAdog style date fields.
  2203.  
  2204.           *   FMail supports the RemoteAccess/FrontDoor Hudson Message Base
  2205.               sharing specifications.
  2206.  
  2207.           *   FMail was written  in C and compiled using  Borland's Turbo C
  2208.               Version 2.0.
  2209.  
  2210.           *   File input/output is performed using standard DOS file handle
  2211.               calls.
  2212.  
  2213.           *   The programs automatically  detect the video environment  and
  2214.               write directly to the screen or DESQview screen buffer.
  2215.  
  2216.           *   FMail returns one of the following errorlevels:
  2217.  
  2218.               4   Error in configuration files
  2219.               3   Control-break pressed
  2220.               2   Insufficient memory available
  2221.               1   Insufficient disk space available or disk error
  2222.               0   No errors occurred
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.                                           37