home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / ma10.zip / MOVEAREA.DOC < prev    next >
Text File  |  1993-07-08  |  6KB  |  151 lines
  1.  
  2. ────────────────────────────────────────
  3.  
  4. MoveArea v1.0
  5. (C)opyright 1993, Bill Dykstra
  6. A RemoteAccess 2.00 Message Area Utility
  7.  
  8. ────────────────────────────────────────
  9.  
  10.  
  11. What is it?
  12.  
  13. MoveArea is a utility that will move a message area from one area number
  14. to another.  MoveArea will ONLY work with RemoteAccess 2.00, on HUDSON
  15. message bases.  JAM bases are not supported by this program.  Once the JAM
  16. format is implemented there may be a version available for moving JAM areas.
  17.  
  18. Usage:   MOVEAREA [source] [target]
  19.  
  20.          [source] = Area number of the message area to move
  21.          [target] = New number of the message area being moved
  22.  
  23.          Use MOVEAREA /C to configure the paths.
  24.  
  25.          Three paths are stored:
  26.             (1) The path to MESSAGES.RA.  This is usually your RemoteAccess
  27.                 main program directory.
  28.             (2) The path to the message base files.  (Usually \RA\MSG or
  29.                 similar).  The MSG*.BBS files and LASTREAD.BBS are stored
  30.                 in this directory.
  31.             (3) The path to the RA text files.  This is where your *.ASC/.ANS
  32.                 files area stored, such as NEWS.A?? and NEWUSER.A??.
  33.  
  34.  
  35. Examples:
  36.  
  37.    MOVEAREA 1 22   will move message area #1 to 22.
  38.                    All messages in area #1 will be changed to area #22.
  39.  
  40.    MOVEAREA /C     will run the configuration section of this program.
  41.  
  42.  
  43.    MOVEAREA 25 323 will do NOTHING, because area #323 is out of the range
  44.                    of 1-200.
  45.  
  46. MoveArea will NOT let you overwrite an already existent message area.
  47. For example, if you have messages areas #1 through 10, and you try to
  48. move Area #2 to area #8, the program will not allow this, because
  49. message area #8 is already being used.
  50.  
  51. MoveArea will not allow you to move a message area that does not exist.
  52. You can't move it if it isn't there.
  53.  
  54. MoveArea will only move message areas in the range of #1 - #200.
  55.  
  56. When a message area is moved, the following things are done to your
  57. files:
  58.  
  59.   ■ MESSAGES.RA is updated.  This changes the message area information
  60.     as defined in RACONFIG (the source area becomes [unused] and the
  61.     source area data is written to the target area record).
  62.  
  63.   ■ MSGHDR.BBS is updated.  All message headers are scanned, and all messages
  64.     found to be in the original (source) area are updated to the new (target)
  65.     area number.
  66.  
  67.   ■ MSGINFO.BBS is updated.  This updates some data about the number of
  68.     messages in each message area.
  69.  
  70.   ■ MSGIDX.BBS is updated.  This updates the index file, which simply contains
  71.     the message area number of each message.
  72.  
  73.   ■ LASTREAD.BBS is updated.  This moves the lastread pointers from the
  74.     original message area to the new message area.
  75.  
  76.   ■ Any MGAxxx.A?? files will be renamed.  For example, if you have:
  77.     MGA1.ANS, MGA1.ASC, and MGA1.AVT files for message area #1, and
  78.     you are moving area 1 to area 110, the files will be renamed to
  79.     MGA110.ANS, MGA110.ASC, and MGA110.AVT.  NOTE: Any old MGAxxx files
  80.     will be deleted!  If you had an old MGA110.ASC file in the text
  81.     files directory, it would be erased before the files are renamed.
  82.     This should not be a problem, since this will only happen if the
  83.     message area in question is no longer in use.  (There just might
  84.     be old ASC/ANS/AVT files sitting around.)
  85.  
  86.  
  87. That's it!
  88.  
  89. I have tested this program on my system quite a bit, but I cannot guarantee
  90. ANYTHING!  USE THIS PROGRAM AT YOUR OWN RISK.  I do my best to be sure the
  91. programs that I write will do exactly what they claim to do, and nothing
  92. more.  Sometimes, however, things get overlooked.  I assume NO responsibility
  93. for any damages that may occur because of your use of this program.  If you
  94. do have any problems PLEASE let me know, and I'll do my very best to fix
  95. things for you.
  96.  
  97. Do NOT use this program while a user is online!  All nodes should be shut
  98. down, to be sure that no share violations occur.  This program does not
  99. check for shared files, so you could (and probably will) trash your message
  100. base if you use it while a user is online.
  101.  
  102. This program is freeware.  I hope you like it!
  103.  
  104. Bill Dykstra
  105. The BillBoard BBS
  106. Newmarket, Ontario Canada
  107. (416) 898-2443
  108. 14.4k v.32b
  109. Fidonet 1:250/932
  110.  
  111. FileRequest MOVEAREA for the latest version.
  112.  
  113. MoveArea is written using standard Borland Pascal 7.0.  No extra units or
  114. libraries were used.
  115.  
  116.  
  117. DO NOT COMPRESS MOVEAREA.EXE with PKlite or any other such program!  MoveArea
  118. will update the actual .EXE file when you configure it!  It can NOT do this
  119. properly if the file is compressed.
  120.  
  121.  
  122. R E M I N D E R:
  123. ───────────────
  124.  
  125. If you move an Echomail area or Netmail area, be SURE to update you mail
  126. packer (Gecho, FastEcho, Imail, or whatever you use) to reflect this change!
  127. You want to make sure new incoming messages get dumped into the new area
  128. number!  If you have a QWK door that does not automatically update the message
  129. areas from MESSAGES.RA, you'll have to update the area numbers in the doors
  130. as well.
  131.  
  132. Doors like Bluewave will automatically read the new areas from MESSAGES.RA,
  133. BUT please note that the users will have to reconfigure their message area
  134. selections.  All the area NUMBERS that they have tagged for downloading will 
  135. still be tagged, BUT, these area numbers may no longer be the areas that they
  136. wanted to download!  The areas change, the numbers don't!   Post an 
  137. announcement to your users reminding them to setup the message areas that
  138. they want to download.
  139.  
  140. PS: You just might want to backup your message files and MESSAGES.RA before
  141. using this program.  I have not had any problems, but I would hate to be
  142. resposible for the loss of your message base.  Until you're satisfied that
  143. the program does what it should, MAKE A BACKUP!
  144.  
  145. I admit, I did NOT make a backup of my message base files... I had a tiny
  146. test base I used for the original testing, but most of my testing was done
  147. with my regular message base.  I didn't have enough HD space to make a copy
  148. of it to work with...  What's my point?  Well, first, don't do what I did.
  149. Second, my message base is still there!!! (Whew..)
  150.  
  151.