home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MBU_110.ZIP / MBUTIL.DOC < prev    next >
Encoding:
Text File  |  1990-05-26  |  36.3 KB  |  975 lines

  1.  
  2.  
  3.  
  4.      MBUTIL - RemoteAccess/QuickBBS Message Base Utility 1.10
  5.      Copyright (C) 1990 Gerard van der Land. All rights reserved.
  6.  
  7.  
  8.  
  9.      Features
  10.      --------
  11.  
  12.      * Sorting messages by board and post date and time
  13.      * Purging messages by number, date or received status
  14.      * Message base packing with AutoRenumber
  15.      * Reply chain linking and subject cleaning
  16.      * Creating index files and fixing all kinds of problems and errors
  17.      * Undeleting deleted messages
  18.      * Moving all messages in one board to another board
  19.      * Posting a file as a message
  20.      * Netmail Import .MSG ==> MSG*.BBS
  21.      * Netmail Export MSG*.BBS ==> .MSG (updates credit)
  22.      * Replacing up to 5 different tearlines in outgoing echomail messages
  23.      * Creating 'Outbound Traffic Report'
  24.      * Build-in help screens for all commands
  25.      * It  does  NOT require  a  specific  BBS program,  mailer  or message
  26.        editor, as it uses its own control file and environment variable
  27.      * Writes logfile in  FrontDoor, Opus,  D'Bridge, Binkley and  QuickBBS
  28.        format
  29.  
  30.  
  31.  
  32.      Disclaimer, License and Other Important Stuff
  33.      ---------------------------------------------
  34.  
  35.            The following points  must be considered, understood  and agreed
  36.      upon BEFORE you use MBUTIL 1.10:
  37.  
  38.      * MBUTIL is distributed  as ShareWare, and  not as FreeWare or  Public
  39.        Domain!
  40.  
  41.      * This  documentation  and  the accompanying  program  is  copyrighted
  42.        material by Gerard van der Land.
  43.  
  44.      * Although care  has been taken to write and  test a program that does
  45.        what this documentation  states, the program  is provided as it  is,
  46.        without  warranty or  guarantee  of any  kind,  either expressed  or
  47.        implied, as to  the quality or  performance of this program,  except
  48.        that it will occupy disk space.
  49.  
  50.      * The author will not be held liable to you or anyone for  any direct,
  51.        indirect, incidental  or consequential  damages, including any  lost
  52.        profits, lost savings which may result  from the use or inability to
  53.        use this program.
  54.        Your  use  of   the  program  constitutes  your  agreement  to  this
  55.        disclaimer and your release of the author from any form of liability
  56.        or litigation.
  57.  
  58.      * You  are granted  limited license  to use  MBUTIL 1.10  and you  are
  59.        encouraged to copy and distribute it in an unmodified way as much as
  60.        you want, as  long as you  still abide to  the conditions  mentioned
  61.        here and no money or other compensation is asked or accepted.
  62.  
  63.                                         1
  64.  
  65.  
  66.  
  67.      System Hardware and Software Requirements
  68.      -----------------------------------------
  69.  
  70.      * An IBM PC, XT, AT or 100% compatible.
  71.      * The amount  of RAM  that should  be available  very much  depends on
  72.        which command you  are using and how  big your message base  is, but
  73.        around 300 KB should  be enough in most  cases. If you run  it under
  74.        DoubleDOS/DesqView,  just   try.  If   there's  not   enough  memory
  75.        available, MBUTIL will certainly let you know!
  76.      * Microsoft  MS-DOS  3.00  / IBM  PC-DOS  3.00  or  above. MBUTIL  was
  77.        successfully tested under MS-DOS 4.01.
  78.      * At least "FILES=15" (or more) in your CONFIG.SYS.
  79.      * A RemoteAccess ≤ 0.0x or QuickBBS 2.xx compatible message base.
  80.  
  81.  
  82.  
  83.      Setup
  84.      -----
  85.  
  86.            Before you use MBUTIL  you should enter your information  in the
  87.      control file MBUTIL.CTL using an ASCII text editor. Explanation of the
  88.      keywords is given there.
  89.  
  90.  
  91.  
  92.      Environment Variable
  93.      --------------------
  94.  
  95.      Usage:
  96.  
  97.         SET MBU=<controfile> [<color>]
  98.  
  99.            To be able to run MBUTIL from any directory, you can use the MBU
  100.      environment variable. If  MBUTIL can't find MBUTIL.CTL  in the current
  101.      path, it will try the open the filename set with MBU. This can also be
  102.      useful for people having  more than one message base, who  can use SET
  103.      to select from their batch file which control file should be used.
  104.  
  105.            <color> is optional and is the default text color, which is also
  106.      used  if  the  control file  was  found  in the  current  path.  It is
  107.      calculated as follows:
  108.  
  109.         <foreground color> + (16 * <background color>)
  110.  
  111.      Colors:
  112.  
  113.         0    Black                4    Red
  114.         1    Blue                 5    Magenta
  115.         2    Green                6    Yellow
  116.         3    Cyan                 7    White
  117.  
  118.            Add 8 for highlighted foreground colors. <color> is 7 by default
  119.      (White text on a Black background).
  120.  
  121.      Example:
  122.  
  123.         SET MBU=C:\RA\MBUTIL.CTL 3
  124.  
  125.  
  126.                                         2
  127.  
  128.  
  129.  
  130.      Specifying Boards
  131.      -----------------
  132.  
  133.            If you must specify a  <board>, you can use the area tag (if you
  134.      have specified an AreasFile in the control file), or #<boardnumber>.
  135.  
  136.            A special fixed area name is  "NETMAIL", which will always refer
  137.      to your NetmailBoard, if defined.
  138.  
  139.  
  140.  
  141.      Help Screens
  142.      ------------
  143.  
  144.            If you run 'MBUTIL', you will see the following help screen:
  145.  
  146.      +-------------------------------------------------------------------+
  147.      | MBUTIL - RemoteAccess/QuickBBS Message Base Utility 1.10          |
  148.      | Copyright (C) 1990 Gerard van der Land. All rights reserved.      |
  149.      |                                                                   |
  150.      | Usage:                                                            |
  151.      |                                                                   |
  152.      |    MBUTIL <command> [<parameters>]                                |
  153.      |                                                                   |
  154.      | Commands:                                                         |
  155.      |                                                                   |
  156.      |    Export      Export netmail messages and replace tearlines      |
  157.      |    Import      Import netmail messages                            |
  158.      |    Index       Create new index files                             |
  159.      |    Link        Create reply chains and clean subjects             |
  160.      |    Move        Move messages in one board to another board        |
  161.      |    Pack        Pack the message base files                        |
  162.      |    Post        Post a file as message in a specified board        |
  163.      |    Purge       Delete messages according to age or number         |
  164.      |    Sort        Sort unread or all messages by board/date/time     |
  165.      |    Undelete    Undelete deleted messages                          |
  166.      |                                                                   |
  167.      | Run 'MBUTIL <command> ?' to get information about <parameters>.   |
  168.      |                                                                   |
  169.      | C:\RA>_                                                           |
  170.      |                                                                   |
  171.      +-------------------------------------------------------------------+
  172.  
  173.      Example:
  174.  
  175.         MBUTIL Purge ?
  176.  
  177.            This will give you  information about the Purge command  and its
  178.      parameters. If a  parameter is  missing or invalid,  MBUTIL will  also
  179.      show you a help screen.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                         3
  190.  
  191.  
  192.  
  193.      Sort
  194.      ----
  195.  
  196.      Usage:
  197.  
  198.         MBUTIL Sort [-All] [-Backup] [-Pack]
  199.  
  200.              The Sort command can  be used to  sort all unread messages  by
  201.        board number and post date and time. This has two advantages:
  202.  
  203.           + When using combined read mode to read new messages for example,
  204.             you won't see messages from different boards mixed up.
  205.           + It reduces the chance that you read a reply to a message before
  206.             you  actually  read the  message  that  was  replied to,  which
  207.             happened pretty often to  me and which was actually  the reason
  208.             why I started  writing MBUTIL in the first place!  But from one
  209.             thing came another...
  210.  
  211.              Reading replies  before the original messages is in most cases
  212.        caused  by  echo  mail  processors that  don't  sort  incoming  mail
  213.        packets, but I think that DOESN'T HAVE TO BE the case, since a reply
  214.        can simply have a shorter or  faster PATH than the message that  was
  215.        replied to.
  216.  
  217.              MBUTIL checks if  there is enough disk  space available. After
  218.        that it scans LASTREAD.BBS to find the highest message that was read
  219.        by all users. MBUTIL assumes there are actually messages to sort and
  220.        starts  rewriting   MSGHDR.BBS  and   MSGTOIDX.BBS  while   scanning
  221.        MSGHDR.BBS to  find out where  to start sorting.  I could  have used
  222.        MSGIDX.BBS for this, but the current way is more reliable and  works
  223.        faster  if  there actually  are messages  to  sort, which  will most
  224.        likely be  the case if you run Sort only each time new messages were
  225.        tossed in to the message base.
  226.  
  227.              MBUTIL will  remove  all reply  chains while  sorting, so  you
  228.        should run 'MBUTIL Link'  each time you used Sort.  The next version
  229.        might Link  while Sorting.  This version can  sort up to  about 9360
  230.        messages.
  231.  
  232.              You  can use '-All' to sort  the entire message base, but THIS
  233.        IS NOT  RECOMMENDED  FOR BBS  SYSTEMS,  as IT  DOES  NOT UPDATE  THE
  234.        LASTREAD.BBS POINTERS (I  suggest you delete LASTREAD.BBS if you use
  235.        this switch). It was only added because some POINTS in the beta-team
  236.        requested it.
  237.  
  238.      Switches:
  239.  
  240.         -All       Sort entire message base (ignores LASTREAD pointers)
  241.         -Backup    Keep the original MSGHDR.BBS as backup (.BAK)
  242.         -Pack      Remove header records of deleted messages
  243.  
  244.  
  245.  
  246.  
  247.              The rest of MBUTIL  is actually a clone of  TosScan(q) Message
  248.        Utility (TSUTIL) 1.00, with some additions and improvements here and
  249.        there. TSUTIL was written by Mats Wallin and Joaquim Homrighausen. I
  250.        hope they won't be angry with me! ;-)
  251.  
  252.                                         4
  253.  
  254.  
  255.  
  256.      Purge
  257.      -----
  258.  
  259.      Usage:
  260.  
  261.         MBUTIL Purge [-File <file>] [<criteria>] [-Convert <output>]
  262.  
  263.              The Purge  command can  be used  to delete  messages based  on
  264.        <criteria> specified per board, like age, received status or maximum
  265.        number  of messages.  <criteria> can  be a  command line  or  a text
  266.        <file> with lines in the following format:
  267.  
  268.        [<board>] [-All] [-Days <days>] [-Rcvd] [-Msgs <number>]
  269.  
  270.               <file> can also  be "RemoteAccess"  or "TosScan", which  will
  271.        use their files, if found in the current path.
  272.  
  273.              If you add '-Convert <output>', you  can convert TosScan or RA
  274.        information to a <output> text file. If you use '-Msgs <msgs>  -Days
  275.        <days> -Rcvd -Convert <output>', your AreasFile will be converted to
  276.        purge file format. You may put comments after a ; in a text <file>.
  277.  
  278.              If  you use '-File  <file> -Days <days>  -Msgs <msgs>', <days>
  279.        and  <msgs> will  apply  to  all  boards for  which  the  number  of
  280.        Days/Msgs was not defined (zero) in <file>.
  281.  
  282.              If you  use '-File <file> <board> -Days  <days> -Msgs <msgs>',
  283.        <days> and <msgs> will override the settings in <file>.
  284.  
  285.              If you use '[-File <file>] [<board>] -Rcvd', received messages
  286.        will be deleted in <board> or all boards.
  287.  
  288.              If you use '-File RemoteAccess [...]', it will delete received
  289.        messages in all boards  where the "Days After Received  Messages are
  290.        Killed" value in RACONFIG is non-zero.
  291.  
  292.              If you want to,  you can still retrieve deleted  messages with
  293.        'MBUTIL Undelete', described later.
  294.  
  295.      Switches:
  296.  
  297.         -All        Delete all messages (won't be used as default)
  298.         -Days       Delete messages older than <days>
  299.         -Rcvd       Delete all received messages
  300.         -Msgs       Delete all except the last <number> messages
  301.         -Convert    Convert AreasFile, MESSAGES.RA or AREAFILE.FD
  302.  
  303.      Examples:
  304.  
  305.      ; Delete messages  older than 2 weeks  and received messages on  board
  306.      10.
  307.      MBUTIL Purge #10 -Days 14 -Rcvd
  308.  
  309.      ; Delete messages in SYSOPS.028 according to information in MBUTIL.PUR
  310.      MBUTIL Purge -File MBUTIL.PUR SYSOPS.028
  311.  
  312.  
  313.  
  314.  
  315.                                         5
  316.  
  317.  
  318.  
  319.      Pack
  320.      ----
  321.  
  322.      Usage:
  323.  
  324.         MBUTIL Pack [-Backup] [-Force] [-Overwrite] [-Renumber]
  325.                     [-Delete] [-Recover]
  326.  
  327.              The Pack command can be used to pack the message base files by
  328.        removing deleted messages.
  329.  
  330.              Pack will by default rewrite the  message base file and delete
  331.        the old files  if the message  base was packed successfully.  If you
  332.        use '-Backup', it will  keep MSGHDR.BAK and MSGTXT.BAK. Note  that I
  333.        don't keep a backup of  the index files. If you should  ever need to
  334.        use your backup message base, just  run 'MBUTIL Index' to create new
  335.        index files. By using  '-Overwrite' you can choose to  overwrite the
  336.        existing files if there's not enough disk space to create new files.
  337.        I personally  always use and  recommend using '-Force'  to overwrite
  338.        the existing message base files,  which has the following advantages
  339.        and disadvantages:
  340.  
  341.           + It  requires no free  disk space at all,  which is actually the
  342.             reason why I always HAVE to use overwrite mode. :-)
  343.  
  344.           + It is much faster (especially  since MBUTIL won't rewrite  text
  345.             blocks that don't need to be moved)
  346.  
  347.           + It causes less  disk fragmentation,  and thus prevents  message
  348.             base access from slowing down.
  349.  
  350.           - It  is  a  little bit  more  dangerous,  because  if MBUTIL  is
  351.             interrupted  while  overwriting, it  will probably  damage your
  352.             message base beyond repair. 'MBUTIL Index -Delete -Renumber' is
  353.             the  best  you can  do  when  this should  happen.  MBUTIL will
  354.             temporary ignore the Ctrl-Break  and Ctrl-C keys when it  is in
  355.             overwrite-mode so you can't accidentally interrupt it.
  356.  
  357.              When MBUTIL has  renumbered the messages,  it will update  the
  358.        LASTREAD pointers in LASTREAD.BBS. If USERS.BBS exists it  will also
  359.        update the 'highest read' pointers in  the user records and reformat
  360.        LASTREAD.BBS if necessary. I recommend using  '-Renumber' regularly.
  361.        MBUTIL will automagically renumber if  the highest message number is
  362.        higher than what you defined using the 'AutoRenumber' keyword in the
  363.        control file.
  364.  
  365.        See 'MBUTIL Index' on  the next page for details  on using '-Delete'
  366.        and '-Recover'.
  367.  
  368.      Switches:
  369.  
  370.         -Backup        Keep the original MSGHDR.BBS and MSGTXT.BBS as .BAK
  371.         -Force         Force overwriting of the existing message base files
  372.         -Overwrite     Overwrite existing files only if short of disk space
  373.         -Renumber      Renumber messages and update LASTREAD pointers
  374.         -Delete        Delete messages crosslinked in MSGTXT.BBS
  375.         -Recover       Move messages in invalid boards to the RecoveryBoard
  376.  
  377.  
  378.                                         6
  379.  
  380.  
  381.  
  382.      Index
  383.      -----
  384.  
  385.      Usage:
  386.  
  387.         MBUTIL Index [-Delete] [-Recover] [-Renumber]
  388.  
  389.        The Index command can be used to create the following index files:
  390.  
  391.           MSGIDX.BBS     This file  contains the message and  board numbers
  392.                          of each parallel records in MSGHDR.BBS. It is used
  393.                          to quickly find a message by  message number or to
  394.                          find the previous/next message on a specific board
  395.                          or in the entire message base.
  396.  
  397.           MSGTOIDX.BBS   This file contains  the name of the  addressees of
  398.                          the messages in the parallel record in MSGHDR.BBS.
  399.                          It contains "* Received *" if a message is already
  400.                          received and "* Deleted *" if a message is already
  401.                          deleted. It is  used to  quickly check the  entire
  402.                          message base for personal mail.
  403.  
  404.           MSGINFO.BBS    This file contains the total number of messages in
  405.                          the entire  message base,  the highest  and lowest
  406.                          message  numbers used  and the number  of messages
  407.                          per  board. It is  used to  give the  BBS program,
  408.                          message  editor  or   echo  mail  processor   this
  409.                          information without having to scan MSGHDR.BBS.
  410.  
  411.              Note that  these index  files are  also created  by the  Pack,
  412.        Purge and Undelete  commands. If  Sort sorted message  it will  also
  413.        create new index files.
  414.  
  415.              You can optionally  delete crosslinked  messages (two or  more
  416.        messages  claiming  partially   or  entirely   the  same  block   in
  417.        MSGTXT.BBS) or messages  pointing to  a non-existing block  (outside
  418.        MSGTXT.BBS). You can also choose to  move messages in invalid boards
  419.        (0 or > 200) to the RecoveryBoard. If you haven't defined one, these
  420.        messages  will  be  deleted  if  you  use the  -Delete  or  -Recover
  421.        switches. Please  note that -Delete  and -Recover  don't update  the
  422.        reply chains.
  423.  
  424.              If the message numbers  really get out of order and/or Pack is
  425.        unable to renumber the messages (for  instance if there are negative
  426.        message numbers or you  don't have enough memory available)  you can
  427.        use the -Renumber  switch to fix  this. Please note  that this  will
  428.        *NOT* update the LASTREAD pointers. Only  use this switch in extreme
  429.        emergencies.  If  you don't  have very  much  memory you  should run
  430.        'MBUTIL Pack -Renumber' regularly or choose a low AutoRenumber value
  431.        to prevent needing this.
  432.  
  433.      Switches:
  434.  
  435.         -Delete        Delete messages crosslinked in MSGTXT.BBS
  436.         -Recover       Move messages in invalid boards to the RecoveryBoard
  437.         -Renumber      Renumber all message numbers in MSGHDR.BBS
  438.  
  439.  
  440.  
  441.                                         7
  442.  
  443.  
  444.  
  445.      Link
  446.      ----
  447.  
  448.      Usage:
  449.  
  450.         MBUTIL Link [-Clean] [-Remove]
  451.  
  452.              The Link command can  be used to  link messages with the  same
  453.        subject in a reply chain that can be walked through with the message
  454.        editor or the BBS program.
  455.  
  456.              MBUTIL  will  always create  new reply  chains for  all boards
  457.        rather than  updating any  existing reply  chains. Deleted  messages
  458.        will  not be  linked. MBUTIL  links messages using  a CRC-32  on the
  459.        message  subjects, ignoring  case and  "Re:" or  "(R)"  junk. Future
  460.        versions of MBUTIL will use the  MSGID and REPLY kludges and/or sort
  461.        the reply chains by post date.
  462.  
  463.              With the -Remove switch  MBUTIL will only remove all  existing
  464.        reply chains.
  465.  
  466.              With the -Clean switch MBUTIL will remove "Re:" and "(R)" junk
  467.        from the subject texts.
  468.  
  469.              I  recommend  running 'Link  -Clean'  each time  messages were
  470.        tossed into the message base.
  471.  
  472.      Switches:
  473.  
  474.         -Clean        Remove "Re:" and "(R)" from subjects
  475.         -Remove       Remove all existing reply chains
  476.  
  477.  
  478.  
  479.      Move
  480.      ----
  481.  
  482.      Usage:
  483.  
  484.         MBUTIL Move <from_board> <to_board>
  485.  
  486.              The Move command can be used to move all messages in one board
  487.        to another board. The messages are  not physically moved, only their
  488.        board number  is changed.  They keep  the same  message numbers  and
  489.        reply chains. Deleted messages will not be moved.
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                         8
  505.  
  506.  
  507.  
  508.      Export
  509.      ------
  510.  
  511.      Usage:
  512.  
  513.         MBUTIL Export [-Crash] [-Direct] [-Keep] [-ReTear] [-Report]
  514.  
  515.      or:
  516.  
  517.         MBUTIL Export <board> <path> [-Delete]
  518.  
  519.              The Export command is  the opposite of the Import  command and
  520.        can be used to  export messages from RemoteAccess message  boards to
  521.        FidoNet  .MSG standard messages.  It will by  default export netmail
  522.        messages from all boards to the NetmailPath if defined.
  523.  
  524.              If netmail was entered using RemoteAccess, those programs will
  525.        increment the  Pending field  in the  user record.  When MBUTIL  has
  526.        exported such  messages, it will  decrement both Pending  and Credit
  527.        fields in the user record (if found).
  528.  
  529.              Netmail will  NOT be exported if  it is destined to  your main
  530.        address or one of your Aka's.
  531.  
  532.              When export is used  to export netmail, it will  also turn off
  533.        invalid  'Outgoing EchoMail' bits  of messages  that don't  have the
  534.        Local bit set, which  fixes the problem that Qecho  exports messages
  535.        that you replied to with FrontDoor 1.99c.  MBUTIL will also create a
  536.        file TRAFFIC.MBU, that contains the number of outbound messages from
  537.        each board. Use '-Report' to produce the report TRAFFIC.RPT.
  538.  
  539.              When you use  the -ReTear switch, MBUTIL will  search outgoing
  540.        echomail messages  for up  to five  specified tearlines and  replace
  541.        them with the matching ones, comparable to ReTear by Cary Howell.
  542.  
  543.              If you specify  <path> <board>, you  can use MBUTIL to  Export
  544.        all messages in an RemoteAccess board to .MSG format. Don't use this
  545.        to export netmail!
  546.  
  547.      Switches:
  548.  
  549.         -All       Send all messages to another zone direct, not via the
  550.                    zonegate (myzone:myzone/destzone)
  551.         -Crash     Send only crash messages to another zone direct
  552.         -Keep      Keep the message in the NetmailPath after they have been
  553.                    sent. Normally to are killed after they have been sent.
  554.         -Delete    Delete messages in the RemoteAccess board after they
  555.                    have been exported. This is always done for netmail
  556.                    with the Kill/Sent bit set, even if you use -Keep.
  557.         -ReTear    Replace the tearlines of Outgoing Echomail messages
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.                                         9
  568.  
  569.  
  570.  
  571.      Import
  572.      ------
  573.  
  574.      Usage:
  575.  
  576.         MBUTIL Import [-Users]
  577.  
  578.      or:
  579.  
  580.         MBUTIL Import <path> <board> [-Delete]
  581.  
  582.              The Import command is  the opposite of the Export  command and
  583.        can be used  to import messages  from FidoNet standard .MSG  message
  584.        files to RemoteAccess message boards.
  585.  
  586.              It will by default import messages from the NetmailPath to the
  587.        NetmailBoard if defined. It only  imports netmail messages that  are
  588.        destined to your main address or one  of your Aka's and if the  name
  589.        of the addressee is one  of the users listed in the control  file or
  590.        found in the user file. If a message is for one of  the users listed
  591.        in the control file, MBUTIL will still search the user file (if any)
  592.        for the username, and replace it exactly as it was written there. If
  593.        you use the -User switch, MBUTIL  will NOT import messages addressed
  594.        to users listed in the control file.
  595.  
  596.              If you specify <path> <board>, you can use MBUTIL to Import an
  597.        entire directory of  .MSG format echomail  messages, for example  to
  598.        import messages from  you Dupe path  to a RemoteAccess board.  Don't
  599.        use this to import netmail!
  600.  
  601.      Switches:
  602.  
  603.         -Delete    Delete the .MSG files after they have been imported in
  604.                    they have been imported in the RemoteAccess.
  605.                    This is always done for netmail.
  606.         -Users     Don't import messages to any of the users defined in the
  607.                    control file
  608.  
  609.      Examples:
  610.  
  611.      ; Import netmail
  612.      MBUTIL Import
  613.  
  614.      ; Import all .MSG files in C:\FD\BADECHO to the area "NEWECHO" and
  615.      ; then delete the .MSG files
  616.      MBUTIL Import C:\FD\BADECHO NEWECHO -Delete
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.                                        10
  631.  
  632.  
  633.  
  634.      Post
  635.      ----
  636.  
  637.      Usage:
  638.  
  639.         MBUTIL Post <file> <board> [-From <from>] [-To <to>]
  640.                                    [-Subject <subject>]
  641.  
  642.              The Post command is similar  to the Import command and  can be
  643.        used to create a message with the contents of  a specified file in a
  644.        specified board. The messages will  have the 'Outgoing Echomail' bit
  645.        set, so they will be exported if you post them in an echomail board.
  646.        Post  can't post  files  larger  than  32 KB.  If  <from>,  <to>  or
  647.        <subject> contains spaces, enclose it in double quotes.
  648.  
  649.      Defaults:
  650.  
  651.         -From       First UserName defined in control file
  652.         -To         All
  653.         -Subject    <file>
  654.  
  655.      Example:
  656.  
  657.         MBUTIL Post C:\MBU_REL.TXT 37 -From "Gerard van.der.Land"
  658.                -To "Everyone" -Subject "Message Base Utility 1.10 release"
  659.  
  660.              One special option not listed on  the help screen is the -Test
  661.        switch. If you  use it,  the Post  command will  have the  following
  662.        format:
  663.  
  664.         MBUTIL Post <number> <board> -Test [...]
  665.  
  666.              MBUTIL  will  post  <number> test  messages  in  the specified
  667.        <board>. Those message will NOT be exported. I  used this switch for
  668.        testing purposes and decided to keep in the release version.
  669.  
  670.  
  671.  
  672.      Undelete
  673.      --------
  674.  
  675.      Usage:
  676.  
  677.         MBUTIL Undelete [<board>]
  678.  
  679.              The  Undelete command  can  be used  to  undelete all  deleted
  680.        messages in all boards or <board>.
  681.  
  682.              When messages are deleted, they are  marked as deleted and not
  683.        physically deleted or overwritten, which means that you can Undelete
  684.        all deleted messages, as long as the message base  file haven't been
  685.        packed yet.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.                                        11
  694.  
  695.  
  696.  
  697.      AreasFile Example
  698.      -----------------
  699.  
  700.            This is an example  for an AreasFile. This file,  usually called
  701.      AREAS.BBS, is used by some echomail processors, like Qecho and ZMail.
  702.  
  703.      /--------------------------------------------------------------------\
  704.      Default origin line ! Sysop name
  705.      1   RA_SUPPORT           [net/nodes...]
  706.      2   RA_SUP.028           [net/nodes...]
  707.      3   LOCAL
  708.      \--------------------------------------------------------------------/
  709.  
  710.             In  this example "RA_SUPPORT" would be the same as "#1". As you
  711.      can see, you can  add local areas to  make it easier to  specify those
  712.      boards.
  713.  
  714.  
  715.  
  716.      Purge File Example
  717.      ------------------
  718.  
  719.            This is an example for a Purge File.
  720.  
  721.      /--------------------------------------------------------------------\
  722.      ; MBUTIL 1.10 Purge File
  723.      ;
  724.      ; Example
  725.      ;
  726.      ; 0 Days or 0 Msgs = unlimited
  727.      ;
  728.      ;Board # of Days  # of Msgs  Rcvd             Comment (optional)
  729.      ;----- --------- ----------- ----- --------------------------------
  730.             -Days  21 -Msgs   100       ; Default values
  731.        #001 -Days  14 -Msgs   200       ; Int. RemoteAccess Support Area
  732.        #002 -Days  21 -Msgs    50       ; Nat. RemoteAccess Support Area
  733.        #003 -Days  28 -Msgs   150 -Rcvd ; Local sysop board
  734.      ;
  735.      ; It can also be like this:
  736.      ;
  737.      RA_SUPPORT -Days 15 -Msgs 300       ; RemoteAccess Support Area
  738.      NETMAIL    -Days 14 -Msgs 200 -Rcvd ; This is the NetmailBoard
  739.      LOCAL      -Days 10 -Msgs 75  -Rcvd ; Local board
  740.      \--------------------------------------------------------------------/
  741.  
  742.            You can also create a Purge File with the -Convert switch:
  743.  
  744.            To convert MESSAGES.RA to a text file:
  745.      MBUTIL Purge -File RemoteAccess [...] -Convert PURGE.RA
  746.  
  747.            To convert AREAFILE>FD to a text file:
  748.      MBUTIL Purge -File TosScan [...] -Convert PURGE.TS
  749.  
  750.            To convert your AreasFile to a text file:
  751.      MBUTIL Purge [...] -Convert PURGE.MBU
  752.  
  753.            You can also specify default values:
  754.      MBUTIL Purge -Days 14 -Msgs 50 -Rcvd -Convert PURGE.MBU
  755.  
  756.                                        12
  757.  
  758.  
  759.  
  760.      Batch File Example
  761.      ------------------
  762.  
  763.      /--------------------------------------------------------------------\
  764.      :Clean
  765.         rem Do your daily/nightly maintenance here.
  766.  
  767.         rem The Purge command depends on what software you are using.
  768.  
  769.         rem In a RemoteAccess environment you can use:
  770.         CD \RA
  771.         MBUTIL Purge -File RemoteAccess
  772.  
  773.         rem In a FrontDoor+TosScan environment you can use:
  774.         CD \FD
  775.         MBUTIL Purge -File TosScan
  776.  
  777.         rem This works in all environments:
  778.         MBUTIL Purge -File MBUTIL.PUR
  779.  
  780.         rem This command deletes invalid messages, recovers messages in
  781.         rem invalid boards and packs and renumbers the message base by
  782.         rem overwriting the existing message base files
  783.         MBUTIL Pack -Force -Renumber -Delete -Recover
  784.         goto Start
  785.  
  786.      :Unpack
  787.         rem Toss incoming echomail, import netmail, sort unread messages
  788.         rem and create reply chains
  789.         <command to toss incoming echomail>
  790.         MBUTIL Import
  791.         MBUTIL Sort -Pack
  792.         MBUTIL Link -Clean
  793.         goto Start
  794.  
  795.      :Net
  796.         rem Only export NetMail
  797.         MBUTIL Export
  798.         goto Start
  799.  
  800.      :Net&Echo
  801.         rem It is not necessary that there is NetMail that needs to be
  802.         rem exported, but we run Export anyway for the ReTear option.
  803.         rem We are sure that EchoMail needs to be exported.
  804.         rem Just replace the "goto Echo" with "goto Net&Echo"
  805.         MBUTIL Export -ReTear
  806.         <command to scan outgoing echomail>
  807.         goto Start
  808.      \--------------------------------------------------------------------/
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.                                        13
  820.  
  821.  
  822.  
  823.      History/Future
  824.      --------------
  825.  
  826.            Until  now  I  spent  quit  some  hours  writing,   testing  and
  827.      documenting  MBUTIL and  I will  keep on  doing that.  There are  also
  828.      things that  can and will  be done  to make MBUTIL  even a  little bit
  829.      smaller  and faster. There is still  some redundant code that could be
  830.      made more compact  and efficient. MBUTIL is  also using quit a  lot of
  831.      memory at the moment,  which can be made less. Further  I'm working on
  832.      my own echomail processor and a full screen personal mail check.
  833.  
  834.  
  835.  
  836.      Registration
  837.      ------------
  838.  
  839.            As long as you don't register, MBUTIL will remind you of that on
  840.      the screen and in the logfile. MBUTIL  is NOT crippled in any way.  If
  841.      you use this program for a period of  time and you decide you like it,
  842.      you can get a personal RegistrationKey by sending:
  843.  
  844.      * $10US - $99US (Whatever the program is worth to you, may also be an
  845.                       equivalent amount in a freely convertible currency).
  846.  
  847.      * The name you want to have defined after the "RegisteredTo" keyword.
  848.  
  849.      * Any questions, comments, suggestions and bug-reports, and ofcourse
  850.        your FidoNet (or else snail mail) address, to:
  851.  
  852.              Gerard van der Land
  853.              Cannenburg 23
  854.              3772 BH Barneveld
  855.              The Netherlands
  856.  
  857.              FidoNet 2:283/1.5 and 2:283/108.1
  858.  
  859.            Users  in  The Netherlands  can  transfer their  registration to
  860.      PostBank giro-account 5.245.162 in The  Netherlands. For usres outside
  861.      The  Netherlands  there are  a few  other  possibilities to  send your
  862.      registration:
  863.  
  864.      * Cash money in a registered letter.
  865.      * Sending a EuroCheque.
  866.      * International money order.
  867.      * Personal  check.  If you  absolutely want  to  do this,  the minimum
  868.        registration fee is $17US, because of the outrageous conversion cost
  869.        the banks charge when cashing a check.
  870.  
  871.            You will receive your key per crashmail (or snailmail if you are
  872.      not in  FidoNet) as  soon as possible  after I  received the  money or
  873.      money order form or check.
  874.  
  875.      Don't forget to register!
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.                                        14
  883.  
  884.  
  885.  
  886.      Technical Notes
  887.      ---------------
  888.  
  889.      * MBUTIL was written using Turbo C 2.00 and Turbo Assembler 1.01.
  890.      * It writes directly to video RAM or DesqView/DoubleDOS virtual screen
  891.        buffer.
  892.      * It can't be  used while an other  program is also using  the message
  893.        base at  the  same time  (multitasking  environments). It  does  not
  894.        support record locking yet, which might change in the near future.
  895.      * Import and Export are fully zone and point aware.
  896.      * Export creates FTS-0001 rev 12 compatible .MSG files.
  897.      * Import can parse Fido and SEAdog style .MSG dates.
  898.      * Link is based on code written by Folkert Wijnstra.
  899.      * You can  use LZEXE  0.91 by Fabrice  Bellard to  reduce the  size of
  900.        MBUTIL.EXE down to 32 KB.
  901.  
  902.      * TRAFFIC.MBU has the follow format:
  903.  
  904.      struct TRAFFIC.MBU {
  905.         unsigned int  Outbound[200]; /* # of outbound messages per board */
  906.         unsigned char Month, Day, Year, Hour, Minute; /* file created */
  907.         unsigned long TotalCost; /* total netmail cost */
  908.      } Traffic;
  909.  
  910.  
  911.  
  912.      Many Thanks To...
  913.      -----------------
  914.  
  915.        ... Eric Lotgerink, Onno  Hagers, Perry de Ronde, Reinier  de Groot,
  916.      Adrie van  Lith, Folkert Wijnstra,  Gerard Sittrop, Rudi  van Lishout,
  917.      Richard B.  van Dijk,  Willem Blink, John  Veldhuis, Sander  Davidson,
  918.      Sander Eek, Ari Sadarjoen, Peter Smink,  Jan Vroonhof, Arjen Lentz and
  919.      all who I forgot...
  920.  
  921.              All  brand  and product  names  are Copyrighted  (C) material,
  922.        Trademarks <tm>  or Registered  Trademarks (R)  of their  respective
  923.        holders:
  924.  
  925.          BinkleyTerm          Bit Bucket Software
  926.          D'Bridge             Chris Irwin
  927.          DesqView             Quarterdeck Systems
  928.          DoubleDOS            SoftLogic Systems
  929.          FrontDoor, TosScan   Joaquim H. Homrighausen
  930.          IBM                  International Business Machines Corporation
  931.          MBUTIL               Gerard van der Land
  932.          Microsoft, MS-DOS    Microsoft Corporation
  933.          Opus                 Wynn Wagner III
  934.          QuickBBS, Qecho      Ultimate Software Technologies, Inc.
  935.          RemoteAccess         Continental Software, Inc.
  936.          ReTear               Cary Howell
  937.          TSUTIL               Mats Wallin and Joaquim H. Homrighausen
  938.          Turbo C,
  939.          Turbo Assembler      Borland International, Inc.
  940.  
  941.  
  942.  
  943.  
  944.  
  945.                                        15
  946.  
  947.  
  948.  
  949.      Other Files I Released Recently
  950.      -------------------------------
  951.  
  952.      * FD199CNG.ZIP (84 KB): The FrontDoor 1.99c Norton USER GUIDE database
  953.  
  954.          This archive contains FD199C.NG, which  needs NG.EXE, the resident
  955.          Norton Guides  program. It  enables you  to consult  the FrontDoor
  956.          manual any time you want by pressing a hot key. It uses menus with
  957.          the same conveniently arranged index as FRODO.DOC does.
  958.  
  959.      * FS_100.ZIP (7 KB): Folder sort 1.00
  960.  
  961.          A  program that enables you to  organize your FrontDoor FOLDER.SYS
  962.          by manually moving  the folders  to the positions  where you  want
  963.          them. You can also sort by title, delete folders or duplicate them
  964.          to save time with adding new ones.
  965.  
  966.      * USA_100.ZIP (21 KB): USERS.BBS Statistics Analyzer 1.00
  967.  
  968.          A statistics  program for  RemoteAccess and  QuickBBS 2.xx.  It is
  969.          very  fast,  small, and  fully  configurable. It  can  produce the
  970.          following QuickBest look-alike surveys:
  971.  
  972.          + Best Downloaders (KB)
  973.          + Best Uploaders (KB)
  974.          + Best Downloaders (Times)
  975.          + Best Uploaders (Times)
  976.          + Best Callers
  977.          + Best Message writers
  978.          + Last Callers
  979.          + Best active Areas
  980.          + File/Message Base Report
  981.          + Security Report with up to 7 Security Levels
  982.          + Flag Report with Setting Flags and up to 7 Authorization Flags
  983.  
  984.      The latest version  will always be  requestable as "USA" and  "MBUTIL"
  985.      from:
  986.  
  987.      2:282/220 (V22b), RAccess The Arena,     Stiens Holland
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.      *==================* Pfff... End Of Documentation *==================*
  1003.  
  1004.  
  1005.                                        16
  1006.  
  1007.