CMSEARCH - CONFMENU Search Engine - v1.06
                       Copyright (c) 1994 by Stacy Smith

                       Original Documentation by  Cliff Watkins
                       Updated by Herbert Bushong
                        
     CMSEARCH  is a utility that will create the "table" files  required by
     ConfMenu v5.x.  ConfMenu is a PCBoard 15.2 PPE and vastly improves the
     way PCBoard will display your network conferences. This EXE can be run
     during your event or it can be run from the command line  whenever you
     make conference changes. The parameters CMSEARCH needs are as follows:
CMSEARCH -Cd:\path\ -Od:\path\filename.ext [-Pkey] [-R#-#<;#>]
     where:
     -C  full path to the CNAMES.@@@ file, including trailing backslash
     -O  full path and filename for the delimited output file
     -P  search for conference name prefix (conditional)
     -R  search range of conference numbers (conditional)
     -S  sort the output file by conference name <at offset #> (optional)
     -B  number of conferences to buffer [default=32] (optional)

     When CMSEARCH runs successfully it exits with an errorlevel of 0.  You
     can use this feature for batch processing if need be.

     The -P and -R  parameters can be used separately OR together depending
     on your needs. Here are some examples:

     If you DON'T use prefixes and Intelec conferences are  1-100 & 150-247
     Then use -R as: -R1-100;150-247        and don't use the -P parameter.

     If you DO use an IN prefix and Intelec conferences are "all over the
     place" such as 1-15 and 20 and 22 and 25-50 etc but none higher than 300
     Then use -PIN -R1-300
     The above tells CMSEARCH to scan for all conferences with a prefix of IN
     but do not scan for conferences past # 300. This is ideal for those with
     thousands of conferences on their systems.
     Or you can use -R1-15;20;22;25-30 etc.
     But using prefixes is so much more "safe and secure" for your total BBS
     operation anyway, a practice I totally recommend to any SysOp.


     Sample output of CMSEARCH is as follows:
IN_Spitfire
16;0;0;0;1;0;0
IN_Moderators
17;0;0;0;1;0;1
IN_Amiga
18;0;0;0;1;0;0
IN_Communicat
19;0;0;0;1;0;0
IN_SysOps
20;0;0;0;1;0;1
IN_BBS_Doors
21;30;0;0;1;0;0
     Line 1 is the conference, line 2 is the 7 settings for the conf on line 1
     The 7 fields of line 2 are delimited with semi-colons and are as follows:
       1 - Conference number
       2 - If public, security level required to join
       3 - Files
       4 - Doors
       5 - Echoed
       6 - Bulletins
       7 - Private


     CMSearch v1.06 Increased maximum number of conferences that can be
     sorted from about 4000 to about 8000 (that oughta hold 'em for
     awhile).  The number of conferences to buffer per disk read is now
     settable via the command line (-B switch).  The character offset
     for the sort can be defined in the -S switch; if not passed,
     defaults to 0 (acts as previous versions).  Added a repeating file
     opening routine that will retry to open a locked file 10 times,
     waiting 1 second between attempts.  Reduced stack frame from 8K to
     2K to save a little memory.

     CMSearch v1.05 fixed a bug in the code if improper commandline used.

     CMSearch v1.04 now supports alphabetical sorts (see above).

     CMSearch v1.03 is set to handle longer conference names in anticipation
     of this inevitable future feature of PCBoard.

     That's about it, if there's anything you feel I've left out of the docs,
     please contact me via Intelec in the IS_Support, PPL_Lang or SysOps 
     conferences.

     And many thanks go out to Stacy Smith, the author of CMSEARCH, for it's
     with his help and support that ConfMenu continues to be the best of it's
     kind!  Stacy is also the author of ULP,  the very best file upload dupe
     checker for PCBoard! Stacy can be contacted in the ULP_Support conference
     on the Intelec Network!