Chris Bonnici's Routine Search Utility (BETA).
Shareware Version


List of topics:
1. Introduction
2. Installation
3. Running the Program
4. Shareware
5. Distribution and Disclaimer
6. Contacting the Author


Introduction
This utility came into being after I realized that the %RS routine supplied as standard in 
MSM did lack a few extras that I regularly needed. The utility performs a routine search 
for a string within user selected routines.

%RS lacked:
? A facility to total the number of lines and total occurrences of the string within the 
found programs. I normally need these values as initial estimates on the duration/cost 
of maintenance runs within existing code. Year 2000 projects are such examples. For 
example, how frequent is a global referenced within a few thousand routines?
? It did not provide a summary. Each search must list the line occurrences. The 
majority of my needs did not require such information (although %CBRS does allow 
the user to select whether the output should be detailed or not).
? %RS does not have a facility to pause the screen. For output to a printer this might 
not be a problem (even though skipping over the perforation is not a bad idea), but 
for those inquiries on the screen a large number of information made reading the 
information close to impossible.
? %CBRS automatically sets page width and page length depending on whether output 
is being directed to a printer (defaults to 132 characters) or screen.

This program is still in BETA and if you encounter a problem with it send an e-
mail to chribonn@letterbox.com.  The more people use it, the quicker it will move into a 
finalized version. Your enhancement suggestion list will also be considered.

Installation
Open the ZIP archive.
Run your version of MSM
Using %RR, load the file %CBRS.RTN into the MGR UCI so that it will be available in 
all other UCI's. 
DO ^%CBRS to run the program.

Running the program.
The program is very simple to run. If you place it in the MGR UCI you would be able to 
invoke it from any other UCI. Once loaded (via a D ^%CBRS) you have to supply the 
following:
? Search for		- The string you want to look up;
? Routine Selector	- The routines you would like to look for;
? Output Device	- Where the search results should be directed to;
? Lines per page	- How many lines will the routine display before pausing;
? Page width	- Self explanatory.

Pressing a `?" gives context sensitive help. Pressing `^' on any prompt takes you to the 
previous one.

Shareware
%CBRS is a shareware program  and there is no charge if you are using this library for 
personal purposes although an e-mail is appreciated. If this program is used within a 
commercial environment a registration fee of $15 is mandatory after the 30 day trial 
period.

Any income earned from this program will be used to initiate some projects in M Web 
Magazine at http://www.mcenter.com/mwm-us/ so if you can pitch in you'll see your 
donation turned into something useful to the entire M community.

For corporate licensing please contact the author.

Distribution and Disclaimer
%CBRS may be distributed by any means, provided that the original files as supplied by 
the author remain intact. This program may be placed on any archive or BBS system.

If used in a commercial environment, the program must be registered if used  beyond the 
evaluation period.

This program can not be bundled with any commercial package or distributed by itself 
without express written permission from the author.

The author of this program accepts no responsibility for damages resulting from the use 
of this product and makes no warranty or representation, either express or implied, 
including but not limited to, any implied warranty of merchantability or fitness for a 
particular purpose. This software is provided "AS IS", and you, its user, assume all risks 
when using it.

By installing this program you implicitly agree to the rules outlined above.

Contacting the Author
The latest version of this program can always be downloaded from Chris 
Bonnici's M Page http://www.geocities.com/SiliconValley/7041). 

Electronically, Chris Bonnici can be reached at chribonn@letterbox.com. 

Comments and suggestions are welcome.
