Randem Systems, Inc.

 

website: http://www.randem.com

support site: http://www.randem.com/cgi-bin/discus/discus.cgi                                                       

 

All Support for this product is done by our support site not by email. If you have questions, comments or suggestions, please visit the support site and give your responses and suggestions at http://www.innoscript.com/cgi-bin/discus/discus.cgi.

 

            This program can add code to you app for commenting, debugging, tracing or just about anything you need to certain routines or every routine in your app. It does a backup of each module, form or class that it changes. The backup can be found in a folder named BACKUP in the folder where your project resides.

 

To use:

 

·        MAKE A BACKUP OF YOUR PROJECT BEFORE YOU START!!!.

·        Select the VBP/VBG Project that you want to change or get information from.

·        Select the Pre Code or Post Code routines or both (Select both for Trace or Error selections).

·        Select Start.

·        Look at your project to review changes.

·        Add the RS General Routines (RSGenRtns.dll) reference to your changed project

 

If you have selected the Trace pre or post code, the trace module will automatically be added to your project.

                       

Pre Code: Code that gets inserted at the beginning of each sub/function.

Post Code: Code that gets inserted at the end of each sub/function.

 

            There are replaceable parameters that you can use in your Pre/Post Code routines that will be replaced with the actual names of the form, sub, function, module or class.            These parameters are listed on the main screen (look in the pre-code Trace for an example).

 

            In the Modules, Forms, Classes and API tabs, if the item was not used in the context of which it was defined it will appear in Red.

 

To add new Pre/Post code names:

 

  1. Type in new name wanted
  2. Click Add

 

To select Pre/Post code:

 

            Use the Drop down box to select the wanted code. It will appear in the window to the right. You can edit what is contained in the window to be what you want to it to be.

 

All defined unused items will be listed in red.

 

            Upon choosing the project to work on the Called Routines report is not run. This report is not run until you select the Called Routines tab.

 

            This selection will also update the API's tab to show the unused API's.

 

Typical Run:

 

  1. Select VBP project file in RSTools.
  2. Select the Trace code template from the PreCode drop down list.
  3. Select the Error code template from the PreCode drop down list.
  4. They will be added to the PreCode list.
  5. Select the Trace code template from the PostCode drop down list.
  6. Select the Error code template from the PostCode drop down list.
  7. They will be added to the PostCode list
  8. Press the Add Code button
  9. The PreCode templates will be added to the beginning of each subroutine/function
  10. The PostCode templates will be added to the end of each subroutine/function
  11. Open your project in the Visual Basic IDE.
  12. Add the reference RSGenRtns.DLL to your project.
  13. Compile your project in Visual Basic to create the exe.

 

When you run your exe, an file .ini file will be created in the name of yourexename.ini. You will need to edit this file to turn the trace on. Find the entry in the [System] section named Trace. Set it to Trace = True, then you can run the exe and it will trace all the calls. Also a folder will be created in the location of your exe named Log.  Your log files will be placed there.

 

      In the youexename Trace.log file, you will find entries that state that a function has started and function has ended. If you match these function up you will know what is happening inside that function call. You can then find out if your application cashed where it was last for the end of the procedure will have not been logged.