
 Ŀ
  N E W O R D E R 

                   NEWORDER Version 1.4 - 03 July 1996

                (C) Copyright 1995-1996, All Rights Reserved
                     Serge Forget - 1:243/68@fidonet

          "Maximus" is a trademark of Scott J. Dudley - Lanius Corp.

 Ŀ
  INTRODUCTION 

   NEWORDER is a utility for Sysops using Maximus and Maximus/2 version 3.00
   or 3.01 ONLY, written by Scott J. Dudley - Lanius Corp.

   - Why I wrote NEWORDER?

     Simply because I got tired of renumbering my file and message areas
     manually, everytime I added or deleted areas.  This is something that
     happens often, with sysops joining or leaving numerous networks.  ;)

   - What it does?

     It renumbers either your MsgArea.ctl or FileArea.ctl files, after you
     have managed to add, delete or reorganized your configuration files.
     This is something that we, sysops, really like to do, fudging with our
     configuration files.  ;)

  *NEW:   You can now add the initial value on the command line, like:
          "NEWORDER FileArea.CTL 200"  (Without the quotes).  This will start
          the renumbering of the areas from 200 and up.  Any "%#neworder xxx"
          statements WILL be ignored.

          Also, NEWORDER will make an automatic backup copy of your original
          CTL file. ;)  There is no more *.new file, the output file is the
          actual CTL file required, all you have to do is scan the file to
          ensure that it is to your liking and run Silt(p).  ;)

          OR, you can use the folowing method:

          All that you have to do, is insert one line at the required
          locations, using the keyword "%#neworder" (without the quotes) and
          the starting value, just before the area that the renumbering
          scheme should start, within your original *.CTL files, for example:

             %#neworder 1
                 .
                 .
                 .
                 .
             %#neworder 100

             FileArea 23
             ACS             Transient
             Desc            (AD) DOS Desktop Programs
             Download        e:\files003\AD-DOSDK\
             Upload          d:\files002\sysop\
             End FileArea

             FileArea 24
             ACS             Transient
             Desc            (AD) DOS Games
             Download        d:\files002\AD-DOSGM\
             Upload          d:\files002\sysop\
             End FileArea

               .
               .
               .
            %#neworder 200
               .
               .
               .
            etc.....


        You get the idea.  ;)


   With this method, whenever NEWORDER encounters this keyword (%#neworder),
   it will reset the Area count to whatever you have chosen.

   For example: %#neworder 100 will start numbering areas from 100.

   Upon execution, the OUPUT file name will be *.CTL.  So, if you use
   MsgArea.ctl as the input file to process, well, the output file name will
   be MsgArea.CTL, with a backup copy named MsgArea.BAK.  NEWORDER WILL tell
   you what the name of the output file will be.

   Enter NEWORDER without any arguments to get the command line reminder.

   Also, when using the second method, if the area renumbering tally is
   greater then a NEWORDER keyword, NEWORDER will barf and tell you on which
   line, in your input CTL file, where there is a conflict.  In other words,
   say you have selected a new renumbering count at a certain location, if
   the last area of the previous group is higher then the new renumbering
   number, NEWORDER will tell you.  All you will have to do in this situation,
   is just to increment your new group starting number to a higher value.

   After executing NEWORDER:

   1-  When satisfied that NEWORDER has done it's job to your liking, delete
       the file MTAG.* in your Maximus root directory.

   2-  Delete *.* in your \Max\olr\dats directory.

   3-  Run Silt(P) to rebuild your Farea & Marea files, and you are all set.


   Garanties?  For this price?  You must be kidding!  There is none, niet,
   null, aucune, nada....  All I can say is, it will occupy disk space, and
   that it works here and it may not work for you, but then again it may.  ;)

   This program was compiled using Borland C++ v4.00.

   This exe file has been compiled for 80386 systems, but should work just
   fine with faster CPU's.  Memory requirements are minimal.

   Comments and suggestions are welcome.

   I hope that it will make your Maximus management easier, as it does
   for me.

 Ŀ
  COMMAND LINE CONTROLS 


    Syntax example:  NEWORDER FileArea.ctl
                     NEWORDER FileArea.ctl 100

    Syntax example:  NEWORDER MsgArea.ctl
                     NEWORDER MsgArea.ctl 200


 Ŀ
  ERROR LEVELS 


                        0 - Normal exit.
                        1 - Input file not found exit.


 Ŀ
  DISTRIBUTION 

    NEWORDER is FREEWARE for NON-commercial users.  You can use it, abuse it,
    break it or what ever you like, but I retain ALL the rights to it.

    Also, reverse engineering of any kind or type is prohibited.

    For commercial users, contact the author for details.

    The Author can be contacted by Fidonet Netmail at 1:243/68, and via the
    following international echomail conferences: in the Maximus support
    conference Muffin; MaxDev; Xenia; and OS2BBS.

 Ŀ
  HISTORY or What's New 

    * 03 July 1996 *

         - Version 1.4 is released by way of MaxFDN.
         - Since I had some spare time, I implemented something that I wanted
           to do since the first version, automatic backup file creation.  ;)
           Now, all you have to do is run NEWORDER, scan the file for
           correctness and run Silt(p).  See the instructions above.

    * 02 July 1996 *

         - Version 1.3 is release by way of MaxFDN.
         - Following a few requests and suggestions, I have added an extra
           command line parameter, where you can specify the value of the
           initial file area number.  Of course, any %#neworder keyword will
           be ignored, since the command line value will have priority.  In
           fact, you do not even have to use the "%#neworder" keyword at all
           all.  <WG>

    * 03 March 1996 *

        - Version 1.2 is released, by way of SDSMAX.
        - Code revision was required in order to get rid of an annoying
          "Null pointer assignment" statement, after running NEWORDER. :(

    * 06 December 1995 *

        - Version 1.1 is released, by way of SDSMAX.
        - Optimized code.
        - Improved this documentation, some information was missing.
        - Cosmetic changes.

    * 19 November 1995 *

        - NEWORDER version 1.00 is released, by way of the software
          distribution network SDSMAX.

 Ŀ
 

