home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / areamgr4.zip / AREAMGR.DOC next >
Text File  |  1994-06-04  |  12KB  |  288 lines
  1.  
  2.   ────────────────────────────────────────────────────────────────────────────
  3.  
  4.   ▀█▀▀▀▄  ▄▀▀▀▀▀▀
  5.    █ █ █  █ █▀▀▀ Dykstra
  6.    █ █ █  ▀▄▄▄▄   Software
  7.    █ ▀ █     ▄ █
  8.   ▀▀▀▀▀  ▀▀▀▀▀ █  (C) Copyright 1993, 1994 William J. Dykstra
  9.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  10.  
  11.   ────────────────────────────────────────────────────────────────────────────
  12.  
  13.               
  14.                               Area Manager v4.0
  15.                      (C) Copyright 1994, Dykstra Software
  16.                             written by Bill Dykstra
  17.  
  18.  
  19.   ────────────────────────────────────────────────────────────────────────────
  20.  
  21.   AreaMGR, short for Area Manager, is a RemoteAccess 2.0x area management
  22.   utility.  AreaMGR will allow you to make global changes to just about all
  23.   of the message area and file area settings, including security levels and
  24.   flag settings!
  25.  
  26.  
  27.   AreaMGR is another quality freeware product from Dykstra Software.
  28.  
  29.   ────────────────────────────────────────────────────────────────────────────
  30.  
  31.   Disclaimer:  Use this program at your own risk.  The author will not be held
  32.   responsible for any damages resulting either directly or indirectly from the
  33.   use of this program.  In other words, if it nukes your hard drive, wrecks
  34.   you car, burns down your house, or in any other way ruins your day, don't
  35.   come looking for me with large blunt objects in your hand.
  36.  
  37.   ────────────────────────────────────────────────────────────────────────────
  38.  
  39.   AreaMGR is designed for making global changes to file and message areas.
  40.   AreaMGR allows you to make changes to ALL of the area settings!
  41.  
  42.   The AreaMGR screens look very similar to the RACONFIG file and message area
  43.   screens, so you should have no problems figuring them out.
  44.  
  45.   AreaMGR looks for the following files in the CURRENT directory:
  46.     CONFIG.RA
  47.     FILES.RA
  48.     MESSAGES.RA
  49.  
  50.   AreaMGR must be able to find these files in the current directory in order
  51.   for the program to work.
  52.  
  53.   When you first run AreaMGR, you will be presented with a menu that simply
  54.   allows you to select "Message Areas" or "File Areas".   Choose whichever
  55.   area type you want to make changes to.
  56.  
  57.   Depending on your selection, a file or message area settings screen will
  58.   be displayed.  These screens are almost identical to RA's RACONFIG screens.
  59.   With these screens you can make changes to any of the fields available.
  60.  
  61.   There are several type of fields available:  Simple data entry fields, where
  62.   you can type in a value (like area Name, Security levels, etc).  Just type
  63.   in whatever value you wish in these fields.
  64.  
  65.   Numeric fields have maximum values of either 255 or 65535, depending on which
  66.   field you are on.  If you enter a number higher than either of these maximums
  67.   the field will automatically be adjusted to the maximum value.  (For example,
  68.   if you enter 900 into the "Age" field, AreaMGR will automatically adjust
  69.   this value to 255 when you press ENTER...)
  70.  
  71.   Many fields are "toggle" fields, where there are a limited number of values
  72.   allowed in these fields.  Use the space bar to cycle through the available
  73.   values for these fields.
  74.  
  75.   AreaMGR is a SMART program.  Even though all the fields are available and
  76.   may be changed, AreaMGR will only change the values of the fields that you
  77.   have placed a new value in. If you leave a field blank, NO CHANGE will be
  78.   made to that field.  If you enter a new value in a field, that value will
  79.   be placed in all the areas that you process.  If you don't want to change
  80.   a field, make sure that it is blank!  Note that in numeric fields, the value
  81.   ZERO (0) is NOT considered blank!  If you enter a 0 into a field, then
  82.   AreaMGR will place a 0 into that field in all areas that you process.  If
  83.   you do not want to make changes to a numeric field, leave it blank, NOT 0!
  84.  
  85.   The flags are the only fields that may be confusing.  The flags work as
  86.   follows:
  87.  
  88.    - any flag that is left with a '.' (period) value  will NOT be changed.
  89.    - any flag that you set to a '-' (dash) value will be cleared in the
  90.      areas that you process.  (A cleared flag shows up as a dash (-) in
  91.      RACONFIG.
  92.    - any flag that you set to an 'X' will be set ON in the areas that you
  93.      process.  (These will appear as X's in RACONFIG)
  94.    - any flag that you set to an 'O' will be set OFF in the areas that you
  95.      process.  This does NOT mean that the flag will be cleared!  It will be
  96.      set OFF.  This is how you can update the NOT flags.  (These will appear
  97.      as O's in RACONFIG)
  98.  
  99.   For example, if you want to clear the Read flag A4, set read flag B2 OFF, and
  100.   set the read flag C6 to ON, your Read flag fields should look like this:
  101.  
  102.        A flag: ...-....
  103.        B flag: .O......
  104.        C flag: .....X..
  105.        D flag: ........
  106.  
  107.   This would make the appropriate changes to the three specified flags, while
  108.   all other flags would remain UNCHANGED.
  109.  
  110.  
  111.   NOTE:  When selecting Archive Types (File areas) or the AKA address (message
  112.   areas), a popup list box will appear, from which you can make a selection.
  113.   These AKA's and archive types are read from CONFIG.RA.  To modify the data
  114.   that appears in these popup list boxes, you must modify the settings in
  115.   RACONFIG.
  116.  
  117.   If you do NOT want to make changes to one of these two fields, select the
  118.   "DO NOT CHANGE" option from the popup list box.  Selecting a blank row will
  119.   NOT have the same result.
  120.  
  121.  
  122.  
  123.  
  124.   Search and Replace
  125.   ──────────────────
  126.  
  127.   Version 4.0 now supports "Search & Replace" on certain fields.
  128.   In message areas, you may now use the Search & Replace feature on the
  129.   Area Name, Origin Line, and JAM Base Name fields.  In file areas you may
  130.   use this option on the Area Name and File Path fields.
  131.  
  132.   This new Search & Replace feature allows you to replace only specific
  133.   text with new text, which is very handy when changing things like a drive
  134.   letter in a file path.
  135.  
  136.   For example:  If all of your file areas are on drive D:, but you then
  137.   buy a new hard drive, and you move your file areas to drive E:, you must
  138.   now update your paths in the RA file areas.  This Search & Replace option
  139.   is perfect for this:  Just search for "D:" and replace it with "E:".  If
  140.   AreaMGR finds "D:" in the path, it will replace it with "E:", and it will
  141.   leave the rest of the path unchanged.
  142.  
  143.   (For example, "D:\RA\FILE\NEWFILES" would become "E:\RA\FILE\NEWFILES")
  144.  
  145.   NOTE: AreaMGR will only find and replace the FIRST occurrence of a string
  146.   in each field.  For example, if you search for "RA" and replace it with
  147.   "RAPRO" in following, only the first "RA" will be changed.
  148.  
  149.   "D:\RA\FILE\RA_FILES" will become "D:\RAPRO\FILE\RA_FILES".  Only the first
  150.   "RA" is changed, so it does NOT become "D:\RAPRO\FILE\RAPRO_FILES".
  151.  
  152.  
  153.    NOTE: The "search" is NOT case sensitive!  If you search for "ra", and "RA"
  154.    is found, it will be considered a match.   The "Replace" text IS case
  155.    sensitive - it will be written to the field exactly how you typed it.
  156.  
  157.    (Example:  Search for: ra
  158.               Replace with: TEsT
  159.  
  160.               Old field found: RA File Area
  161.               New field value: TEsT File Area
  162.  
  163.               The "RA" is replaced with "TEsT".)
  164.  
  165.  
  166.  
  167.  
  168.  
  169.   Ready to process your changes?
  170.   ─────────────────────────────
  171.   When you have entered all of the values that you want changed, you may
  172.   press F10 to begin processing these changes.
  173.  
  174.   To exit the screen without processing your changes, press ESC.
  175.   To exit the screen and begin processing the changes, press F10.
  176.  
  177.   When you press F10, you will be asked to select the areas that you want to
  178.   change.  You may either change a RANGE of areas (from a starting area number
  179.   to an ending area number) or you may change any number of individually
  180.   selected areas.
  181.  
  182.   You will be asked to enter the starting and ending area numbers.  The
  183.   starting and ending area numbers that you enter WILL also be processed.
  184.  
  185.   For example, if you enter a starting area number of 4, and an ending area
  186.   number of 7, areas 4, 5, 6, and 7 will be updated.  (They are INCLUSIVE).
  187.  
  188.   If you wish to select individual areas for processing, rather than using
  189.   a range of areas, press F2 instead of entering the Starting area number.
  190.   A pop up list of all available areas will be displayed, and you may then tag
  191.   any areas that you want to change from this list.
  192.  
  193.   Keys available when tagging:
  194.  
  195.      F1  = Help
  196.      F10 = Process
  197.      ESC = Cancel
  198.  
  199.      ENTER = Toggle tagged status and move down one row
  200.      SPACE = Toggle tagged status and remain on this row
  201.      +     = Tag this area and move down one row
  202.      -     = UnTag this area and move down one row
  203.      F5    = Tag ALL areas
  204.      F6    = UnTag ALL areas
  205.  
  206.   Any tagged areas will have a check mark (√) displayed to the right of the
  207.   area name.   The following is a sample of the area selection box:
  208.  
  209.         ╔═══════════[ Tag the areas to be updated ]════════════╗
  210.         ║     1 │ SysOp to User Messages                   │   ║
  211.         ║     2 │ Private User to User Mail                │ √ ║
  212.         ║     3 │ General Chat (Real Names)                │ √ ║
  213.         ║     4 │ General Chat (Aliases Allowed)           │ √ ║
  214.         ║     5 │ Programming Talk                         │   ║
  215.         ║     6 │ BBS Ads                                  │   ║
  216.         ║     7 │ Sports Chat                              │ √ ║
  217.         ║     8 │ [Unused]                                 │   ║
  218.         ║     9 │ [Unused]                                 │ √ ║
  219.         ║    10 │ NetMail                                  │ √ ║
  220.         ║    11 │ Fidonet Netmail                          │   ║
  221.         ║    12 │ GalukoNet Netmail                        │   ║
  222.         ║    13 │ QuinteNet Netmail                        │   ║
  223.         ║    14 │ InterSports Netmail                      │   ║
  224.         ║    15 │ [Unused]                                 │   ║
  225.         ║    16 │ Genealogy Net Netmail                    │   ║
  226.         ║    17 │ TO: Dear Abby...                         │   ║
  227.         ║    18 │ Dear Abby Replies...                     │   ║
  228.         ╚═[ ESC=Cancel ]══════[ F1=Help ]══════[ F10=Process ]═╝
  229.  
  230.  
  231.   In the above example, areas 2,3,4,7,9 and 10 are tagged.  If you press F10
  232.   at this point, these areas would be processed.
  233.  
  234.  
  235.   NOTE: If you enter a value in the JAM area name field (when changing message
  236.   areas) this value will ONLY be stored in your message area settings if the
  237.   area being updated is a JAM area.  If the area being updated is a HUDSON
  238.   area, the JAM area name will NOT be updated.  (This can be handy for making
  239.   global changes to your JAM area names if you ever need to do this, because
  240.   it will skip over the HUDSON areas without updating the JAM name for those
  241.   areas.)
  242.  
  243.  
  244.  
  245.   ────────────────────────────────────────────────────────────────────────────
  246.  
  247.   Well, that's about all I have to say.   Hopefully you can understand how
  248.   this works.  Feel free to contact me if you have any questions, suggestions,
  249.   or if you find any bugs.
  250.  
  251.   I know, these docs really suck.  Sigh.  This program is pretty straight
  252.   forward, so you should be able to figure it out...  after all, you must
  253.   have figured out RACONFIG by now, and its pretty much the same.
  254.  
  255.   If somebody really gets bored they could always rewrite these for me... :)
  256.  
  257.   Enjoy!
  258.  
  259.  
  260.   ────────────────────────────────────────────────────────────────────────────
  261.  
  262.   Registration:
  263.  
  264.   There is none!  This is freeware!
  265.   
  266.   I'd love to hear from you - netmail, Internet e-mail, whatever!  Even better,
  267.   to show your appreciation (assuming you like the program <smirk>) send me
  268.   a postcard... preferrably of your city!  (I like to see the places where my
  269.   stuff gets used).
  270.  
  271.   ────────────────────────────────────────────────────────────────────────────
  272.  
  273.   Contacting the author:
  274.  
  275.   Bill Dykstra
  276.   189 Bristol Road
  277.   Newmarket, ON  Canada
  278.   L3Y 7X9
  279.  
  280.   BBS:  The BillBoard BBS
  281.         (905) 898-2443
  282.         Fidonet 1:250/932
  283.  
  284.   Internet: bill.dykstra@canrem.com
  285.  
  286.   ────────────────────────────────────────────────────────────────────────────
  287.   [End Of File]
  288.