Chris Bonnici's Routine Search Utility (BETA).
Shareware Version
List of topics:
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 lacks:
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 frequently is a global referenced within a few thousand routines?
It did not provide a summary. Each search lists only 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 send an e-mail to chribonn@softhome.net. 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://geocities.datacellar.net/cbonnici 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 (i.e. separate from the rest of the archive) 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://geocities.datacellar.net/SiliconValley/7041). Choose from the index Download M
Electronically, Chris Bonnici can be reached at chribonn@softhome.net.
Comments and suggestions are welcome.
"Any income earned from this program will be used to initiate some projects in M Web Magazine"
