home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MAM100.ZIP / MAMOVE.DOC < prev    next >
Encoding:
Text File  |  1994-05-22  |  6.1 KB  |  195 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              ------------
  9.                              MAMOVE v1.00
  10.                              ------------
  11.  
  12.           RemoteAccess v2.0x message area positioning utility
  13.  
  14.           Copyright John Kristoff 1994.  All rights reserved.
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.     INTRODUCTION
  26.  
  27.         As a SysOp who recently switched to RemoteAccess, I found it
  28.         strange that I could not change the order of my message areas
  29.         like I could with my previous BBS program.  Occasionally I
  30.         add and remove message areas from my system.  I also like to
  31.         keep common areas listed together.
  32.  
  33.         I looked for a utility that would allow me to quickly and
  34.         easily move one area to another position in the area list,
  35.         but I could not find one that worked properly.
  36.  
  37.         MAMOVE will allow you to quickly, easily and most
  38.         importantly, safely move a message area to anywhere in your
  39.         area list.
  40.  
  41.  
  42.         
  43.     BEFORE YOU BEGIN
  44.  
  45.             * * * * * * * * * C A U T I O N * * * * * * * * * * 
  46.  
  47.             Moving message areas can cause other third party
  48.             utilities not to work properly.  For example,
  49.             FastEcho v1.40, requires the area number of your
  50.             Netmail area and some QWK readers may toss messages
  51.             into the wrong area if index files are not being
  52.             used by the their accompanying offline readers.
  53.  
  54.             * * * * * * * * * C A U T I O N * * * * * * * * * *
  55.  
  56.         MAMOVE recreates the MESSAGES.RA file which RemoteAccess uses
  57.         to maintain information about each message area on your
  58.         system.  Before MAMOVE makes any changes to your existing
  59.         data file, it will make a backup copy named MESSAGES.BAK in
  60.         the directory where MESSAGES.RA is found.
  61.  
  62.         In order for MAMOVE to run properly, it has to know where
  63.         MESSAGES.RA is.  It will first look for the environment
  64.         variable RA which should be set to your main BBS directory.
  65.         This variable is usually set in the AUTOEXEC.BAT or startup
  66.         batch file of your BBS as in the following example:
  67.  
  68.             SET RA=C:\RA
  69.  
  70.         If the environment variable RA is not set, MAMOVE will try
  71.         to open MESSAGES.RA in the current directory.
  72.  
  73.  
  74.  
  75.     GETTING STARTED
  76.  
  77.         You must specify two command line arguments when running
  78.         MAMOVE.  The syntax is shown below:
  79.  
  80.             MAMOVE <source> <dest>
  81.  
  82.         <source> is the number of the message area you wish to move.
  83.  
  84.         <dest> is the number of the message area that <source> should
  85.         precede.
  86.  
  87.         Below is a list of a few message areas I have on my system:
  88.  
  89.             1: E-Mail (Local)
  90.             2: Netmail (Fido)
  91.             3: Dr. Debug's Lab (Fido)
  92.             4: C Programming (Fido)
  93.             5: alt.folklore.computers (Usenet)
  94.             6: RA_UTIL (Fido)
  95.             7: Chatter (Local)
  96.  
  97.  
  98.         The 7th area, "Chatter" is a local message area that would be
  99.         better listed closer to the top.  I would run MAMOVE like
  100.         this:
  101.  
  102.             MAMOVE 7 2
  103.  
  104.         This command would move "Chatter" before the "Netmail" area
  105.         causing the new area list to look like this:
  106.  
  107.             1: E-Mail (Local)
  108.             2: Chatter (Local)
  109.             3: Netmail (Fido)
  110.             4: Dr. Debug's Lab (Fido)
  111.             5: C Programming (Fido)
  112.             6: alt.folklore.computers (Usenet)
  113.             7: RA_UTIL (Fido)
  114.  
  115.         To determine the number of an area, you should check your
  116.         setup in RACONFIG.
  117.  
  118.  
  119.  
  120.     EXAMPLES
  121.  
  122.         The following message area list will be used for all the
  123.         following examples:
  124.  
  125.             1: E-Mail (Local)
  126.             2: Netmail (Fido)
  127.             3: Dr. Debug's Lab (Fido)
  128.             4: C Programming (Fido)
  129.             5: alt.folklore.computers (Usenet)
  130.             6: RA_UTIL (Fido)
  131.             7: Chatter (Local)
  132.  
  133.         1). To move "Chatter" to area #1:
  134.  
  135.                 MAMOVE 7 1
  136.  
  137.         2). To move "Netmail" to the last area in the list:
  138.  
  139.                 MAMOVE 2 8
  140.             or  MAMOVE 2 3293838
  141.             or  MAMOVE 2 32
  142.  
  143.                 Note: If <dest> is greater than the last area,
  144.                       <source> will become the last area.
  145.  
  146.         3). To move "Chatter" to area #7:
  147.  
  148.                 MAMOVE 7 7
  149.  
  150.                 Note: This is legal, but the area list does not
  151.                       change.
  152.  
  153.         4). To move "Chatter" to area #0:
  154.  
  155.             Help screen is diplayed.  Area numbers must be a minimum
  156.             of 1 and a maximum of, well..., over 2 billion!  (You
  157.             show me someone who has over 2 billion message areas and
  158.             I'll show you someone whose nightly events take 3 years
  159.             to run).
  160.  
  161.  
  162.  
  163.     NOTES
  164.  
  165.         MAMOVE is free for use, abuse or misuse.  You may use MAMOVE
  166.         as much as you want and as often as you want without having
  167.         to send any registration fee, send a postcard, drink a beer
  168.         for me, donate to your favorite charity, or send me a netmail
  169.         message telling me that you're using it.
  170.  
  171.         Now for the bad news, support for MAMOVE is guaranteed to be
  172.         worth as much as you paid for it.
  173.  
  174.         C source code is included with the MAMOVE package in hopes
  175.         that others may take from it to further the development of
  176.         similar programs.
  177.  
  178.                                                John Kristoff
  179.                                                Chicago, IL
  180.                                                05/22/94
  181.         
  182.  
  183.         You should be able to track me down through any of the
  184.         following channels, but they are subject to change.  Please
  185.         use the channels listed first and work your way down if
  186.         necessary.
  187.  
  188.         FidoNet echo: RA_UTIL
  189.         FidoNet echo: DR_DEBUG
  190.      FidoNet Netmail: John Kristoff, 1:115/743
  191.                  BBS: (312) 587-8756, v.32bis/16.8K HST, Chicago, IL
  192.             Internet: John.Kristoff@xroads.chigate.com
  193.             Internet: jkristof@mica.meddean.luc.edu
  194.           CompuServe: 74111,3652
  195.